WsGetErrorString-Funktion (webservices.h)

Artikel
03/03/2024

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

Freigeben über