IBackgroundCopyError::GetErrorDescription-Methode (bits.h)

Ruft den dem Fehler zugeordneten Fehlertext ab.

Syntax

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

Parameter

[in] LanguageId

Gibt das Gebietsschema an, das zum Generieren der Beschreibung verwendet werden soll. Verwenden Sie zum Erstellen des Sprachbezeichners das MAKELANGID-Makro . Verwenden Sie beispielsweise das folgende Codebeispiel, um US-Englisch anzugeben.

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

Verwenden Sie die folgenden Aufrufe, um den Standardbenutzersprachbezeichner des Systems abzurufen.

LANGIDFROMLCID(GetThreadLocale())

[out] pErrorDescription

Null-beendete Zeichenfolge, die den Fehlertext enthält, der dem Fehler zugeordnet ist. Rufen Sie die CoTaskMemFree-Funktion auf, um ppErrorDescription frei zu machen, wenn Sie fertig sind.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Rückgabecode	Beschreibung
S_OK	Beschreibung des Fehlers wurde erfolgreich abgerufen.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
E_INVALIDARG	Der LanguageId-Parameter darf nicht 0 sein.
HRESULT_FROM_WIN32(ERROR_RESOURCE_LANG_NOT_FOUND)	Für das Gebietsschema ist keine Zeichenfolge verfügbar.

Hinweise

Sie können auch die IBackgroundCopyManager::GetErrorDescription-Methode aufrufen, um den Einem Fehlercode zugeordneten Fehlertext abzurufen.

Beschreibungen für HTTP-Fehler werden lokalisiert.

Windows XP/2000: Beschreibungen für HTTP-Fehler sind nicht lokalisiert.

Beispiele

Weitere Informationen finden Sie im Beispielcode im Thema Behandlung von Fehlern .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	bits.h
Bibliothek	Bits.lib
DLL	QmgrPrxy.dll

Weitere Informationen

IBackgroundCopyError::GetError

IBackgroundCopyError::GetErrorContextDescription

IBackgroundCopyError::GetFile

IBackgroundCopyManager::GetErrorDescription