XtfGetErrorTextA
지정된HRESULT에 대한 사용자 친화적인 오류 메시지와 사용자 동작 텍스트를 가져옵니다.
구문
매개 변수
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 문자를 위한 공간이 포함되어야 합니다.
반환 값
형식: HRESULT 성공하면S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
S_OK가 반환되면 함수가 성공했습니다. errorMessageBuffer와 userActionTextBuffer는 지정된 HRESULT에 대한 오류 메시지와 사용자 동작 텍스트로 각각 설정됩니다.
HRESULT_FROM_WIN32(ERROR_MORE_DATA)가 반환되면 errorMessageBuffer 또는 userActionTextBuffer에 제공된 버퍼가 충분히 크지 않은 것입니다. errorMessageBufferLength와 userActionTextBufferLength는 지정된 HRESULT에 대한 오류 메시지와 사용자 동작 텍스트의 필요한 버퍼 길이로 각각 설정됩니다.
다른 HRESULT 코드가 반환되면 예기치 않은 오류가 발생한 것입니다.
설명
XtfGetErrorText에 전달된 HRESULT가 인식된 XBOX Tools Framework(XTF) 오류 코드가 아닌 경우, errorMessageBuffer는 “Unspecified error”로 설정됩니다. 이 결과를 사용하여 지정된 HRESULT가 인식된 XTF 오류 코드인지 확인할 수 있습니다. 인식된 XTF 오류 코드에 대한 자세한 내용은 XTF 전송 오류(NDA 항목)를 참조하세요.
요구 사항
헤더: xtfapi.h 라이브러리: XtfApi.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)함께 보기
XtfConsoleControlXBOX Tools Framework 네이티브 API 참조