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 |
|---|---|
|
Beschreibung des Fehlers wurde erfolgreich abgerufen. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
|
Der LanguageId-Parameter darf nicht 0 sein. |
|
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