Freigeben über


IBackgroundCopyError::GetErrorContextDescription-Methode (bits.h)

Ruft die Beschreibung des Kontexts ab, in dem der Fehler aufgetreten ist.

Syntax

HRESULT GetErrorContextDescription(
  [in]  DWORD  LanguageId,
  [out] LPWSTR *pContextDescription
);

Die Parameter

[in] LanguageId

Gibt das Gebietsschema an, das zum Generieren der Beschreibung verwendet werden soll. Verwenden Sie das MAKELANGID-Makro , um den Sprachbezeichner zu erstellen. Verwenden Sie z. B. das folgende Codebeispiel, um US-Englisch anzugeben.

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

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

LANGIDFROMLCID(GetThreadLocale())

[out] pContextDescription

Null-beendete Zeichenfolge, die die Beschreibung des Kontexts enthält, in dem der Fehler aufgetreten ist. Rufen Sie die CoTaskMemFree-Funktion auf, um ppContextDescription frei zu geben, wenn Sie fertig sind.

Rückgabewert

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

Rückgabecode Description
S_OK
Die Beschreibung des Kontexts wurde erfolgreich abgerufen.
E_OUTOFMEMORY
Nicht genügend Arbeitsspeicher ist 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.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP
Mindestanforderungen für unterstützte Server Windows Server 2003
Zielplattform Fenster
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

Siehe auch

IBackgroundCopyError::GetError

IBackgroundCopyError::GetErrorDescription

IBackgroundCopyError::GetFile