Metodo IBackgroundCopyError::GetErrorDescription (bits.h)

Articolo
02/26/2024

Recupera il testo dell'errore associato all'errore.

Sintassi

HRESULT GetErrorDescription(
  [in]  DWORD  LanguageId,
  [out] LPWSTR *pErrorDescription
);

Parametri

[in] LanguageId

Identifica le impostazioni locali da usare per generare la descrizione. Per creare l'identificatore della lingua, usare la macro MAKELANGID . Ad esempio, per specificare l'inglese statunitense, usare l'esempio di codice seguente.

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

Per recuperare l'identificatore di lingua utente predefinito del sistema, usare le chiamate seguenti.

LANGIDFROMLCID(GetThreadLocale())

[out] pErrorDescription

Stringa con terminazione null contenente il testo dell'errore associato all'errore. Chiamare la funzione CoTaskMemFree per liberare ppErrorDescription al termine.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito	Descrizione
S_OK	Descrizione dell'errore recuperato correttamente.
E_OUTOFMEMORY	Memoria insufficiente per completare l’operazione.
E_INVALIDARG	Il parametro LanguageId non può essere 0.
HRESULT_FROM_WIN32(ERROR_RESOURCE_LANG_NOT_FOUND)	Nessuna stringa è disponibile per le impostazioni locali.

Commenti

È anche possibile chiamare il metodo IBackgroundCopyManager::GetErrorDescription per recuperare il testo dell'errore associato a un codice di errore.

Le descrizioni per gli errori HTTP vengono localizzate.

Windows XP/2000: Le descrizioni per gli errori HTTP non vengono localizzate.

Esempio

Vedere il codice di esempio nell'argomento Gestione degli errori .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bits.h
Libreria	Bits.lib
DLL	QmgrPrxy.dll

Vedi anche

IBackgroundCopyError::GetError

IBackgroundCopyError::GetErrorContextDescription

IBackgroundCopyError::GetFile

IBackgroundCopyManager::GetErrorDescription

Condividi tramite