Funzione WSManGetErrorMessage (wsman.h)

Articolo
08/28/2023

Recupera i messaggi di errore associati a un determinato codice di errore e lingua.

Sintassi

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

Parametri

[in] apiHandle

Specifica l'handle API restituito da una chiamata WSManInitialize . Questo parametro non può essere NULL.

flags

Riservato per utilizzi futuri. Deve essere zero.

[in, optional] languageCode

Specifica il nome del codice di lingua che deve essere utilizzato per localizzare l'errore. Per altre informazioni sui nomi di codice del linguaggio, vedere la specifica RFC 3066 di Internet Engineering Task Force all'indirizzo http://www.ietf.org/rfc/rfc3066.txt. Se non viene specificato un codice di lingua, viene utilizzata la lingua dell'interfaccia utente del thread.

errorCode

Specifica il codice di errore per il messaggio di errore richiesto. Questo codice di errore può essere un codice di errore esadecimale o decimale da una funzionalità winRM, WinHTTP o un'altra funzionalità del sistema operativo Windows.

messageLength

Specifica il numero di caratteri che è possibile archiviare nel buffer dei messaggi di output, incluso il carattere di terminazione Null . Se questo parametro è zero, il parametro message deve essere NULL.

[out] message

Specifica il buffer di output in cui archiviare il messaggio. Questo buffer deve essere allocato e deallocato dal client. Il buffer deve essere sufficientemente grande per archiviare il messaggio e il carattere di terminazione Null . Se questo parametro è NULL, il parametro messageLength deve essere NULL.

[out] messageLengthUsed

Specifica il numero effettivo di caratteri scritti nel buffer di output, incluso il carattere di terminazione Null . Questo parametro non può essere NULL. Se i parametri messageLength o message sono zero, la funzione restituirà ERROR_INSUFFICIENT_BUFFER e questo parametro verrà impostato sul numero di caratteri necessari per archiviare il messaggio, incluso il carattere di terminazione Null .

Valore restituito

Questo metodo restituisce zero in caso di esito positivo. In caso contrario, questo metodo restituisce un codice di errore.

Requisiti


Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Libreria	WsmSvc.lib
DLL	WsmSvc.dll
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2 e Windows Vista con SP2

Condividi tramite