IBackgroundCopyError::GetErrorContextDescription-Methode (bits.h)

  • Artikel

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