XtfGetErrorText
지정된 HRESULT에 대한 사용자 친화적 오류 메시지와 사용자 작업 텍스트를 가져옵니다.
구문
HRESULT XtfGetErrorText(
HRESULT HResult,
PWSTR *errorMessageBuffer,
UINT32 *errorMessageBufferLength,
PWSTR *userActionTextBuffer,
UINT32 *userActionTextBufferLength
)
매개 변수
HResult
형식: HRESULT
[in] 오류 메시지와 사용자 작업 테스트를 조회하는 HRESULT입니다.
errorMessageBuffer
형식: PWSTR*
[out] null 종료 문자열로 오류 메시지를 수신하는 버퍼에 대한 포인터입니다. 필요한 버퍼 길이를 확인하려면 이 매개 변수를 nullptr(으)로 설정하고 errorMessageBufferLength 매개 변수를 0으로 설정합니다. 호출 시 종료 null 문자를 포함하여 errorMessageBufferLength가 WCHAR에서 필요한 버퍼의 길이로 설정됩니다.
errorMessageBufferLength
형식: UINT32*
[in, out] 입력 시 WCHAR의 오류 메시지 버퍼 길이입니다. 버퍼 길이에는 종료 null 문자 공간이 포함되어야 합니다. 출력 시에는 WCHAR의 errorMessageBuffer의 필요 길이입니다.
userActionTextBuffer
형식: PWSTR*
[out] null 종료 문자열로 사용자 작업 텍스트를 수신하는 버퍼에 대한 포인터입니다. 필요한 버퍼 길이를 확인하려면 이 매개 변수를 nullptr(으)로 설정하고 userActionTextBufferLength 매개 변수를 0으로 설정합니다. 호출 시 종료 null 문자를 포함하여 userActionTextBufferLength가 WCHAR에서 필요한 버퍼의 길이로 설정됩니다.
userActionTextBufferLength
형식: UINT32*
[in, out] WCHAR의 사용자 작업 텍스트 버퍼의 길이입니다. 버퍼 길이에는 종료 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 도구 프레임워크(XTF) 오류 코드가 아닌 경우 errorMessageBuffer(이)가 “미지정 오류”로 설정됩니다. 이 결과를 사용하여 지정된 HRESULT(이)가 인식되는 XTF 오류 코드인지 여부를 확인할 수 있습니다. 인식되는 XTF 오류 코드에 대한 자세한 내용은 XTF 전송 오류(NDA 항목)권한 부여 필요를 참조하세요.
요구 사항
헤더: xtfapi.h
라이브러리: XtfApi.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)