Compartir a través de

Función WSManGetErrorMessage (wsman.h)

  • Artículo

Recupera los mensajes de error asociados a un error y códigos de idioma concretos.

Sintaxis

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

Parámetros

[in] apiHandle

Especifica el identificador de API devuelto por una llamada WSManInitialize . Este parámetro no puede ser NULL.

flags

Reservado para uso futuro. Debe ser cero.

[in, optional] languageCode

Especifica el nombre de código de idioma que se debe usar para localizar el error. Para obtener más información sobre los nombres de código de lenguaje, vea la especificación RFC 3066 del Grupo de tareas de ingeniería de Internet en http://www.ietf.org/rfc/rfc3066.txt. Si no se especifica un código de idioma, se usa el idioma de la interfaz de usuario del subproceso.

errorCode

Especifica el código de error para el mensaje de error solicitado. Este código de error puede ser un código de error hexadecimal o decimal de winRM, WinHTTP u otra característica del sistema operativo Windows.

messageLength

Especifica el número de caracteres que se pueden almacenar en el búfer de mensajes de salida, incluido el terminador null . Si este parámetro es cero, el parámetro message debe ser NULL.

[out] message

Especifica el búfer de salida en el que se almacenará el mensaje. El cliente debe asignar y desasignar este búfer. El búfer debe ser lo suficientemente grande como para almacenar el mensaje y el terminador null . Si este parámetro es NULL, el parámetro messageLength debe ser NULL.

[out] messageLengthUsed

Especifica el número real de caracteres escritos en el búfer de salida, incluido el terminador nulo . Este parámetro no puede ser NULL. Si los parámetros messageLength o message son cero, la función devolverá ERROR_INSUFFICIENT_BUFFER y este parámetro se establecerá en el número de caracteres necesarios para almacenar el mensaje, incluido el terminador null .

Valor devuelto

Este método devuelve cero si se ejecuta correctamente. De lo contrario, este método devuelve un código de error.

Requisitos

   
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Plataforma de destino Windows
Encabezado wsman.h
Library WsmSvc.lib
Archivo DLL WsmSvc.dll
Redistribuible Windows Management Framework en Windows Server 2008 con SP2 y Windows Vista con SP2