WPRCFormatError
WPRCFormatError
는 HRESULT 오류 코드를 기반으로 오류 메시지의 서식을 지정하도록 설계된 함수입니다. 오류 메시지를 검색하는 방법을 제공합니다.
구문
HRESULT WPRCFormatError(
_In_ HRESULT Hresult,
_In_opt_ LPUNKNOWN pUnknown,
_Out_ BSTR* pbstrMessage,
_Out_opt_ BSTR* pbstrDescription,
_Out_opt_ BSTR* pbstrDetailedDescription
);
매개 변수
Hresult
(_In_ HRESULT)
: 형식을 지정해야 하는 HRESULT 오류 코드입니다. 이는 필수 매개 변수입니다.
pUnknown
(_In_opt_ LPUNKNOWN)
: 오류의 서식을 지정하기 위한 추가 컨텍스트를 제공할 수 있는 선택적 인터페이스 포인터입니다. 사용하지 않을 경우 이 작업을 수행할 NULL
수 있습니다.
pbstrMessage
(_Out_ BSTR*)
: 기본 오류 메시지를 받을 문자열에 대한 포인터 BSTR
입니다. 필수 출력 매개 변수입니다.
pbstrDescription
(_Out_opt_ BSTR*)
: 오류에 대한 BSTR
자세한 설명을 받을 문자열에 대한 선택적 포인터입니다. 필요하지 않은 경우 이 작업을 수행할 NULL
수 있습니다.
pbstrDetailedDescription
(_Out_opt_ BSTR*)
: 오류에 대한 BSTR
보다 자세한 설명을 받을 문자열에 대한 선택적 포인터입니다. 필요하지 않은 경우에도 이 작업을 수행할 NULL
수 있습니다.
Return Value
함수는 HRESULT 코드를 반환합니다. 성공적인 실행은 일반적으로 S_OK 표시됩니다. 실패는 함수를 실행하는 동안 오류가 발생했음을 나타내는 다른 HRESULT 코드로 표시됩니다.