WSManGetErrorMessage 함수(wsman.h)

특정 오류 및 언어 코드와 관련된 오류 메시지를 검색합니다.

구문

DWORD WSManGetErrorMessage(
  [in]           WSMAN_API_HANDLE apiHandle,
                 DWORD            flags,
  [in, optional] PCWSTR           languageCode,
                 DWORD            errorCode,
                 DWORD            messageLength,
  [out]          PWSTR            message,
  [out]          DWORD            *messageLengthUsed
);

매개 변수

[in] apiHandle

WSManInitialize 호출에서 반환된 API 핸들을 지정합니다. 이 매개 변수는 NULL일 수 없습니다.

flags

다음에 사용하도록 예약됩니다. 0이어야 합니다.

[in, optional] languageCode

오류를 지역화하는 데 사용해야 하는 언어 코드 이름을 지정합니다. 언어 코드 이름에 대한 자세한 내용은 의 인터넷 엔지니어링 태스크 포스 http://www.ietf.org/rfc/rfc3066.txt에서 RFC 3066 사양을 참조하세요. 언어 코드를 지정하지 않으면 스레드의 사용자 인터페이스 언어가 사용됩니다.

errorCode

요청된 오류 메시지에 대한 오류 코드를 지정합니다. 이 오류 코드는 WinRM, WinHTTP 또는 기타 Windows 운영 체제 기능의 16진수 또는 10진수 오류 코드일 수 있습니다.

messageLength

null 종결자를 포함하여 출력 메시지 버퍼에 저장할 수 있는 문자 수를 지정합니다. 이 매개 변수가 0이면 메시지 매개 변수는 NULL이어야 합니다.

[out] message

메시지를 저장할 출력 버퍼를 지정합니다. 이 버퍼는 클라이언트에서 할당하고 할당 취소해야 합니다. 버퍼는 메시지와 null 종결자를 저장할 수 있을 만큼 커야 합니다. 이 매개 변수가 NULL인 경우 messageLength 매개 변수는 NULL이어야 합니다.

[out] messageLengthUsed

null 종결자를 포함하여 출력 버퍼에 기록된 실제 문자 수를 지정합니다. 이 매개 변수는 NULL일 수 없습니다. messageLength 또는 메시지 매개 변수가 0이면 함수는 ERROR_INSUFFICIENT_BUFFER 반환하고 이 매개 변수는 null 종결자를 포함하여 메시지를 저장하는 데 필요한 문자 수로 설정됩니다.

반환 값

이 메서드는 성공하면 0을 반환합니다. 그렇지 않으면 이 메서드는 오류 코드를 반환합니다.

요구 사항