> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfGetErrorTextA

> XtfGetErrorTextA

# XtfGetErrorTextA

지정된 `HRESULT`에 대한 사용자 친화적인 오류 메시지와 사용자 동작 텍스트를 가져옵니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XtfGetErrorTextA(
         HRESULT HResult,
         PSTR *errorMessageBuffer,
         UINT32 *errorMessageBufferLength,
         PSTR *userActionTextBuffer,
         UINT32 *userActionTextBufferLength
)  
```

<a id="parametersSection" />

### 매개 변수

*HResult*\
형식: HRESULT

\[in] 오류 메시지와 사용자 동작 텍스트를 조회할 `HRESULT`입니다.

*errorMessageBuffer*\
형식: PSTR\*

\[out] null로 종료된 문자열로 오류 메시지를 받는 버퍼에 대한 포인터입니다. 필요한 버퍼 길이를 확인하려면 이 매개 변수를 `nullptr`로 설정하고 *errorMessageBufferLength* 매개 변수를 0으로 설정하세요. 호출 시 *errorMessageBufferLength*는 종료 null 문자를 포함하여 필요한 버퍼 길이(CHAR 단위)로 설정됩니다.

*errorMessageBufferLength*\
형식: UINT32\*

\[in, out] 입력 시 오류 메시지 버퍼의 길이(CHAR 단위)입니다. 버퍼 길이에는 종료 null 문자를 위한 공간이 포함되어야 합니다. 출력 시에는 **errorMessageBuffer**의 필요한 길이(CHAR 단위)입니다.

*userActionTextBuffer*\
형식: PSTR\*

\[out] null로 종료된 문자열로 사용자 동작 텍스트를 받는 버퍼에 대한 포인터입니다. 필요한 버퍼 길이를 확인하려면 이 매개 변수를 `nullptr`로 설정하고 *userActionTextBufferLength* 매개 변수를 0으로 설정하세요. 호출 시 *userActionTextBufferLength*는 종료 null 문자를 포함하여 필요한 버퍼 길이(CHAR 단위)로 설정됩니다.

*userActionTextBufferLength*\
형식: UINT32\*

\[in, out] 사용자 동작 텍스트 버퍼의 길이(CHAR 단위)입니다. 버퍼 길이에는 종료 null 문자를 위한 공간이 포함되어야 합니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

성공하면 `S_OK`를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

`S_OK`가 반환되면 함수가 성공했습니다. `errorMessageBuffer`와 `userActionTextBuffer`는 지정된 `HRESULT`에 대한 오류 메시지와 사용자 동작 텍스트로 각각 설정됩니다.

`HRESULT_FROM_WIN32(ERROR_MORE_DATA)`가 반환되면 `errorMessageBuffer` 또는 `userActionTextBuffer`에 제공된 버퍼가 충분히 크지 않은 것입니다. `errorMessageBufferLength`와 `userActionTextBufferLength`는 지정된 `HRESULT`에 대한 오류 메시지와 사용자 동작 텍스트의 필요한 버퍼 길이로 각각 설정됩니다.

다른 HRESULT 코드가 반환되면 예기치 않은 오류가 발생한 것입니다.

<a id="remarksSection" />

## 설명

`XtfGetErrorText`에 전달된 `HRESULT`가 인식된 XBOX Tools Framework(XTF) 오류 코드가 아닌 경우, `errorMessageBuffer`는 "Unspecified error"로 설정됩니다. 이 결과를 사용하여 지정된 `HRESULT`가 인식된 XTF 오류 코드인지 확인할 수 있습니다. 인식된 XTF 오류 코드에 대한 자세한 내용은 [XTF 전송 오류(NDA 항목)](/tools/tools-console/commandlinetools/xtf-transport-errors)를 참조하세요.

<a id="requirementsSection" />

## 요구 사항

**헤더:** xtfapi.h

**라이브러리:** XtfApi.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## 함께 보기

[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)\
[XBOX Tools Framework 네이티브 API 참조](/reference/tools/xtf/atoc-xtf-native)


## Related topics

- [XtfGetErrorText](/ko/reference/tools/xtf/xtfconsolecontrol/functions/xtfgeterrortext-xtfconsolecontrol-xbox-microsoft-m.md)
- [XtfGetAumid](/ko/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md)
- [PartyTextToSpeechProfile::GetGender](/ko/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getgender.md)
- [PartyTextToSpeechProfile::GetIdentifier](/ko/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getidentifier.md)
- [PartyTextToSpeechProfile::GetName](/ko/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getname.md)