WsGetErrorString-Funktion (webservices.h)

  • Artikel

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.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll