WsCall-Funktion (webservices.h)

Artikel
03/03/2024

Wird intern vom Dienstproxy verwendet, um die angegebenen Argumente gemäß den angegebenen Metadaten zu formatieren und in einer Nachricht zu senden. Die Anwendung sollte diese Funktion niemals direkt aufrufen.

Syntax

HRESULT WsCall(
  [in]           WS_SERVICE_PROXY               *serviceProxy,
  [in]           const WS_OPERATION_DESCRIPTION *operation,
  [in, optional] const void                     **arguments,
  [in]           WS_HEAP                        *heap,
                 const WS_CALL_PROPERTY         *callProperties,
  [in]           const ULONG                    callPropertyCount,
  [in, optional] const WS_ASYNC_CONTEXT         *asyncContext,
  [in, optional] WS_ERROR                       *error
);

Parameter

[in] serviceProxy

Zeiger auf eine WS_SERVICE_PROXY Struktur, die den Dienstproxy darstellt.

[in] operation

Zeiger auf eine WS_OPERATION_DESCRIPTION-Struktur , die die Metadaten für den Aufruf enthält.

[in, optional] arguments

Ein Array von Zeigern auf die einzelnen Argumente für den Dienstvorgang, der durch den Operation-Parameter dargestellt wird.

Die Anzahl der Elemente muss der Anzahl von Parametern entsprechen, die als Teil von WS_OPERATION_DESCRIPTION im Vorgangsparameter angegeben sind.

[in] heap

Zeiger auf eine WS_HEAP-Struktur , die den Heap darstellt, aus dem Arbeitsspeicher für den Aufruf zugewiesen wird.

callProperties

Ein Array von WS_CALL_PROPERTY Strukturen, die die Aufrufeigenschaften enthalten.

[in] callPropertyCount

Die Anzahl der Eigenschaften im Aufrufeigenschaftenarray.

[in, optional] asyncContext

Zeiger auf Informationen zum asynchronen Aufrufen der Funktion. Übergeben Sie NULL , um die Funktion synchron aufzurufen.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

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

Rückgabecode	Beschreibung
WS_E_INVALID_OPERATION	Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.
WS_E_OPERATION_ABANDONED	Der Vorgang wurde abgebrochen.
WS_E_OPERATION_TIMED_OUT	Der Vorgang wurde innerhalb der zugewiesenen Zeit nicht abgeschlossen.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
WS_S_ASYNC	Der asynchrone Vorgang steht noch aus.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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