Funzione WsCall (webservices.h)
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 |
---|---|
|
L'operazione non è consentita a causa dello stato corrente dell'oggetto . |
|
È stata superata una quota. |
|
L'operazione è stata abbandonata. |
|
L'operazione non è stata completata entro il tempo assegnato. |
|
Memoria insufficiente per completare l'operazione. |
|
Uno o più argomenti non sono validi. |
|
L'operazione asincrona è ancora in sospeso. |
|
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 |