wiauDbgErrorHr-Funktion (wiautil.h)

Die wiauDbgErrorHr-Funktion protokolliert eine Nachricht, die ein HRESULT und die zugehörige Fehlermeldungszeichenfolge enthält.

Syntax

void wiauDbgErrorHr(
  HRESULT hr,
  LPCSTR  fname,
  LPCSTR  fmt,
  ...     
);

Parameter

hr

Gibt das zu protokollierende HRESULT an.

fname

Zeiger auf eine Zeichenfolge, die den Namen der Funktion oder Methode enthält, in die der Aufruf von wiauDbgDump eingefügt wird.

fmt

Zeiger auf eine Formatzeichenfolge, die eine Variablenargumentliste angibt, die mit einer ANSI-Formatzeichenfolge beginnt, die die Nachricht und alle Konvertierungsspezifizierer enthält. Die Auslassungspunkte (...) gibt eine variable Anzahl von Argumenten an, die ausgegeben werden sollen.

...

Zusätzliche Parameter.

Rückgabewert

Keine

Bemerkungen

Die wiauDbgErrorHr-Funktion protokolliert in der Regel zwei Zeilen in der Protokolldatei oder im Debugger oder beides. Die erste Zeile enthält den Text des fmt-Parameters , einschließlich Daten, sofern angegeben. Die zweite Zeile enthält das HRESULT und die meldungszeichenfolge, die diesem HRESULT zugeordnet ist. Das folgende Beispiel zeigt, wie diese Funktion aufgerufen werden kann:

wiauDbgErrorHr(hr, "AllocateBuffer", "Buffer size is %d bytes", size);

Anforderungen

Weitere Informationen

wiauDbgDump

wiauDbgError

wiauDbgTrace

wiauDbgWarning