Funzione WSManGetErrorMessage (wsman.h)
Recupera i messaggi di errore associati a un determinato codice di errore e lingua.
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
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 .
Questo metodo restituisce zero in caso di esito positivo. In caso contrario, questo metodo restituisce un codice di errore.
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 |