Partager via

Fonction WSManGetErrorMessage (wsman.h)

  • Article

Récupère les messages d’erreur associés à un code d’erreur et de langue particulier.

Syntaxe

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

Paramètres

[in] apiHandle

Spécifie le handle d’API retourné par un appel WSManInitialize . Ce paramètre ne peut pas avoir la valeur NULL.

flags

Réservé pour un usage futur. Doit être zéro.

[in, optional] languageCode

Spécifie le nom de code de langue qui doit être utilisé pour localiser l’erreur. Pour plus d’informations sur les noms de code de langage, consultez la spécification RFC 3066 de l’Internet Engineering Task Force à l’adresse http://www.ietf.org/rfc/rfc3066.txt. Si aucun code de langue n’est spécifié, la langue de l’interface utilisateur du thread est utilisée.

errorCode

Spécifie le code d’erreur du message d’erreur demandé. Ce code d’erreur peut être un code d’erreur hexadécimal ou décimal d’une fonctionnalité WinRM, WinHTTP ou une autre fonctionnalité du système d’exploitation Windows.

messageLength

Spécifie le nombre de caractères pouvant être stockés dans la mémoire tampon de message de sortie, y compris la terminaison null . Si ce paramètre est égal à zéro, le paramètre de message doit avoir la valeur NULL.

[out] message

Spécifie la mémoire tampon de sortie dans laquelle stocker le message. Cette mémoire tampon doit être allouée et libérée par le client. La mémoire tampon doit être suffisamment grande pour stocker le message et la fin null . Si ce paramètre a la valeur NULL, le paramètre messageLength doit avoir la valeur NULL.

[out] messageLengthUsed

Spécifie le nombre réel de caractères écrits dans la mémoire tampon de sortie, y compris la fin null . Ce paramètre ne peut pas avoir la valeur NULL. Si les paramètres messageLength ou message sont zéro, la fonction retourne ERROR_INSUFFICIENT_BUFFER et ce paramètre est défini sur le nombre de caractères nécessaires pour stocker le message, y compris la terminaison null .

Valeur retournée

Cette méthode retourne zéro en cas de réussite. Sinon, cette méthode retourne un code d’erreur.

Spécifications

   
Client minimal pris en charge Windows 7
Serveur minimal pris en charge Windows Server 2008 R2
Plateforme cible Windows
En-tête wsman.h
Bibliothèque WsmSvc.lib
DLL WsmSvc.dll
Composant redistribuable Windows Management Framework sur Windows Server 2008 avec SP2 et Windows Vista avec SP2