Поделиться через

Функция 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

Указывает дескриптор API, возвращаемый вызовом WSManInitialize . Этот параметр не может иметь значение NULL.

flags

Зарезервировано для последующего использования. Должен равняться нулю.

[in, optional] languageCode

Указывает имя кода языка, которое должно использоваться для локализации ошибки. Дополнительные сведения об именах кодов языка см. в спецификации RFC 3066 целевой группы по разработке в Интернете по адресу http://www.ietf.org/rfc/rfc3066.txt. Если код языка не указан, используется язык пользовательского интерфейса потока.

errorCode

Указывает код ошибки для запрошенного сообщения об ошибке. Этот код ошибки может быть шестнадцатеричным или десятичным кодом ошибки из WinRM, WinHTTP или другого компонента операционной системы Windows.

messageLength

Указывает количество символов, которые могут храниться в буфере выходных сообщений, включая символ конца NULL . Если этот параметр равен нулю, параметр сообщения должен иметь значение NULL.

[out] message

Указывает выходной буфер, в котором будет храниться сообщение. Этот буфер должен быть выделен и освобожден клиентом. Буфер должен быть достаточно большим для хранения сообщения и признака конца null . Если этот параметр имеет значение NULL, параметр messageLength должен иметь значение NULL.

[out] messageLengthUsed

Указывает фактическое число символов, записанных в выходной буфер, включая признак конца null . Этот параметр не может иметь значение NULL. Если параметры messageLength или message равны нулю, функция вернет ERROR_INSUFFICIENT_BUFFER , и для этого параметра будет задано количество символов, необходимое для хранения сообщения, включая символ конца NULL .

Возвращаемое значение

Этот метод возвращает ноль при успешном выполнении. В противном случае этот метод возвращает код ошибки.

Требования

   
Минимальная версия клиента Windows 7
Минимальная версия сервера Windows Server 2008 R2
Целевая платформа Windows
Header wsman.h
Библиотека WsmSvc.lib
DLL WsmSvc.dll
Распространяемые компоненты Windows Management Framework в Windows Server 2008 с пакетом обновления 2 (SP2) и Windows Vista с пакетом обновления 2 (SP2)