Condividi tramite

Funzione WsCall (webservices.h)

  • Articolo

Usato internamente dal proxy del servizio per formattare gli argomenti specificati in base ai metadati specificati e inviarli in un messaggio. L'applicazione non deve mai chiamare direttamente questa funzione.

Sintassi

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
);

Parametri

[in] serviceProxy

Puntatore a una struttura WS_SERVICE_PROXY che rappresenta il proxy del servizio.

[in] operation

Puntatore a una struttura WS_OPERATION_DESCRIPTION contenente i metadati per la chiamata.

[in, optional] arguments

Matrice di puntatori ai singoli argomenti per l'operazione del servizio rappresentata dal parametro operation .

Il numero di elementi deve corrispondere al numero di parametri specificati come parte di WS_OPERATION_DESCRIPTION nel parametro operation.

[in] heap

Puntatore a una struttura WS_HEAP che rappresenta l'heap da cui viene allocata la memoria per la chiamata.

callProperties

Matrice di strutture WS_CALL_PROPERTY contenenti le proprietà della chiamata.

[in] callPropertyCount

Numero di proprietà nella matrice delle proprietà della chiamata.

[in, optional] asyncContext

Puntatore alle informazioni per richiamare la funzione in modo asincrono. Passare NULL per richiamare la funzione in modo sincrono.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito Descrizione
WS_E_INVALID_OPERATION
 L'operazione non è consentita a causa dello stato corrente dell'oggetto .
WS_E_QUOTA_EXCEEDED
 È stata superata una quota.
WS_E_OPERATION_ABANDONED
 L'operazione è stata abbandonata.
WS_E_OPERATION_TIMED_OUT
 L'operazione non è stata completata entro il tempo assegnato.
E_OUTOFMEMORY
 Memoria insufficiente per completare l'operazione.
E_INVALIDARG
 Uno o più argomenti non sono validi.
WS_S_ASYNC
 L'operazione asincrona è ancora in sospeso.
Altri errori
Questa funzione può restituire altri errori non elencati in precedenza.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione webservices.h
Libreria WebServices.lib
DLL WebServices.dll