WPRCFormatError
WPRCFormatError
è una funzione progettata per formattare i messaggi di errore in base ai codici di errore HRESULT. Consente di recuperare i messaggi di errore.
Sintassi
HRESULT WPRCFormatError(
_In_ HRESULT Hresult,
_In_opt_ LPUNKNOWN pUnknown,
_Out_ BSTR* pbstrMessage,
_Out_opt_ BSTR* pbstrDescription,
_Out_opt_ BSTR* pbstrDetailedDescription
);
Parametri
Hresult
(_In_ HRESULT)
: codice di errore HRESULT che deve essere formattato. Si tratta di un parametro obbligatorio.
pUnknown
(_In_opt_ LPUNKNOWN)
: puntatore a interfaccia facoltativo che potrebbe fornire contesto aggiuntivo per la formattazione dell'errore. Questa operazione può essere NULL
se non utilizzata.
pbstrMessage
(_Out_ BSTR*)
: puntatore a una BSTR
stringa che riceverà il messaggio di errore primario. Si tratta di un parametro di output obbligatorio.
pbstrDescription
(_Out_opt_ BSTR*)
: puntatore facoltativo a una BSTR
stringa che riceverà una descrizione più dettagliata dell'errore. Questo può essere NULL
se non necessario.
pbstrDetailedDescription
(_Out_opt_ BSTR*)
: puntatore facoltativo a una BSTR
stringa che riceverà una descrizione ancora più dettagliata dell'errore. Questo può anche essere NULL
se non necessario.
Valore restituito
La funzione restituisce un codice HRESULT. Un'esecuzione riuscita viene in genere indicata da S_OK. L'errore è indicato da qualsiasi altro codice HRESULT, che indica un errore durante l'esecuzione della funzione.