Freigeben über

WSManGetErrorMessage-Funktion (wsman.h)

  • Artikel

Ruft die Fehlermeldungen ab, die einem bestimmten Fehler und Sprachcodes zugeordnet sind.

Syntax

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

Parameter

[in] apiHandle

Gibt das API-Handle an, das von einem WSManInitialize-Aufruf zurückgegeben wird. Dieser Parameter darf nicht NULL sein.

flags

Für die zukünftige Verwendung reserviert. Muss Null sein.

[in, optional] languageCode

Gibt den Sprachcodenamen an, der zum Lokalisieren des Fehlers verwendet werden soll. Weitere Informationen zu den Sprachcodenamen finden Sie in der RFC 3066-Spezifikation der Internet Engineering Task Force unter http://www.ietf.org/rfc/rfc3066.txt. Wenn kein Sprachcode angegeben wird, wird die Benutzeroberflächensprache des Threads verwendet.

errorCode

Gibt den Fehlercode für die angeforderte Fehlermeldung an. Dieser Fehlercode kann ein hexadezimaler oder dezimaler Fehlercode aus einem WinRM-, WinHTTP- oder einem anderen Windows-Betriebssystemfeature sein.

messageLength

Gibt die Anzahl der Zeichen an, die im Ausgabemeldungspuffer gespeichert werden können, einschließlich des NULL-Abschlussators . Wenn dieser Parameter 0 ist, muss der NachrichtenparameterNULL sein.

[out] message

Gibt den Ausgabepuffer an, in dem die Nachricht gespeichert werden soll. Dieser Puffer muss vom Client zugewiesen und zugeordnet werden. Der Puffer muss groß genug sein, um die Nachricht und den NULL-Abschluss zu speichern. Wenn dieser Parameter NULL ist, muss der messageLength-ParameterNULL sein.

[out] messageLengthUsed

Gibt die tatsächliche Anzahl von Zeichen an, die in den Ausgabepuffer geschrieben werden, einschließlich des NULL-Abschlussators . Dieser Parameter darf nicht NULL sein. Wenn entweder der MessageLength - oder der Nachrichtenparameter 0 ist, gibt die Funktion ERROR_INSUFFICIENT_BUFFER zurück, und dieser Parameter wird auf die Anzahl von Zeichen festgelegt, die zum Speichern der Nachricht erforderlich sind, einschließlich des NULL-Abschlussators .

Rückgabewert

Diese Methode gibt bei Erfolg null zurück. Andernfalls gibt diese Methode einen Fehlercode zurück.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Zielplattform Windows
Kopfzeile wsman.h
Bibliothek WsmSvc.lib
DLL WsmSvc.dll
Verteilbare Komponente Windows Management Framework unter Windows Server 2008 mit SP2 und Windows Vista mit SP2