IBackgroundCopyError::GetErrorContextDescription-Methode (bits.h)

Artikel
03/01/2024

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

Syntax

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

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] 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	Beschreibung
S_OK	Die Beschreibung des Kontexts 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.

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::GetErrorDescription

IBackgroundCopyError::GetFile

Freigeben über