WsCreateError-Funktion (webservices.h)

  • Artikel

Erstellt ein Fehlerobjekt, das an Funktionen übergeben werden kann, um umfassende Fehlerinformationen aufzuzeichnen.

Syntax

HRESULT WsCreateError(
       const WS_ERROR_PROPERTY *properties,
  [in] ULONG                   propertyCount,
       WS_ERROR                **error
);

Parameter

properties

Ein Array von WS_ERROR_PROPERTY Strukturen, die optionale Fehlereigenschaften enthalten.

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

error

Bei Erfolg ein Zeiger, der die Adresse der WS_ERROR Struktur empfängt, die das erstellte Fehlerobjekt darstellt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Wenn Sie das Fehlerobjekt nicht lange benötigen, geben Sie es frei, indem Sie die WsFreeError-Funktion aufrufen.

Standardmäßig ist die Sprache aller sprachabhängigen Informationen im Fehlerobjekt die aktuelle Benutzeroberflächenstandardsprache. Sie können die Sprache jedoch ändern, indem Sie die eigenschaft WS_ERROR_PROPERTY_LANGID festlegen. Weitere Informationen finden Sie in der WS_ERROR_PROPERTY_ID-Enumeration .

Anforderungen

   
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