AMGetErrorTextW-Funktion (errors.h)

Die AMGetErrorText--Funktion ruft die Fehlermeldung für einen bestimmten Rückgabecode mithilfe der aktuellen Spracheinstellung ab.

Diese Funktion konvertiert HRESULT- Zurücksenden von Codes in Fehlermeldungen. Die Konstante MAX_ERROR_TEXT_LEN gibt die maximale Anzahl von Zeichen in einer Fehlermeldung an.

Syntax

AMOVIEAPI DWORD AMGetErrorTextW(
  HRESULT hr,
  LPWSTR  pbuffer,
  DWORD   MaxLen
);

Parameter

hr

HRESULT- Wert.

pbuffer

Zeigen Sie auf einen Zeichenpuffer, der die Fehlermeldung empfängt.

MaxLen

Anzahl der Zeichen in pBuffer.

Rückgabewert

Gibt die Anzahl der im Puffer zurückgegebenen Zeichen oder null zurück, wenn ein Fehler aufgetreten ist.

Bemerkungen

Anmerkung

Der Header errors.h definiert AMGetErrorText als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Zielplattform- Fenster
Header- errors.h
Library Quarz.lib

Siehe auch

Funktionen

  • Last updated on