WsGetErrorString-Funktion (webservices.h)

Ruft eine Fehlerzeichenfolge aus einem Fehlerobjekt ab.

Syntax

HRESULT WsGetErrorString(
  [in]  WS_ERROR  *error,
  [in]  ULONG     index,
  [out] WS_STRING *string
);

Parameter

[in] error

Das Fehlerobjekt, das die Zeichenfolge enthält.

[in] index

Der nullbasierte Index, der die abzurufende Zeichenfolge identifiziert. Die erste Fehlerzeichenfolge (Index 0) ist die Zeichenfolge, die zuletzt dem Fehlerobjekt hinzugefügt wurde (mit WsAddErrorString). Wenn WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE im Fehlerobjekt angezeigt wird, ist der entsprechende Fehlertext im letzten Index verfügbar.

Die Anzahl der Fehler kann mithilfe von WS_ERROR_PROPERTY_STRING_COUNT abgerufen werden.

[out] string

Die zurückgegebene Zeichenfolge. Die Zeichenfolge ist gültig , bis WsResetError oder WsFreeError aufgerufen wird.

Die Zeichenfolge ist nicht 0 (null) beendet.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Hinweise

Die Zeichenfolge befindet sich in der Sprache, die von der LANGID-Eigenschaft des Error-Objekts angegeben wird. Dies kann mithilfe von WsGetErrorProperty mit WS_ERROR_PROPERTY_LANGID abgerufen werden.

Anforderungen