Freigeben über


WsCall-Funktion (webservices.h)

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