Funzione WsCreateServiceProxy (webservices.h)

Articolo
08/27/2023

Crea un proxy del servizio con le proprietà specificate.

Sintassi

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 WS_SERVICE_PROXY              **serviceProxy,
  [in, optional] WS_ERROR                      *error
);

Parametri

[in] channelType

Valore di enumerazione WS_CHANNEL_TYPE che rappresenta il tipo di canale per il proxy del servizio.

[in] channelBinding

Valore di enumerazione WS_CHANNEL_BINDING che rappresenta l'associazione del canale.

[in, optional] securityDescription

Struttura WS_SECURITY_DESCRIPTION che rappresenta la descrizione della sicurezza.

properties

Matrice di strutture WS_PROXY_PROPERTY contenenti proprietà facoltative per il proxy del servizio.

Il valore di questo parametro può essere NULL, nel qual caso il parametro propertyCount deve essere 0 (zero).

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

channelProperties

Matrice di strutture WS_CHANNEL_PROPERTY contenenti proprietà del canale facoltative. Il valore di questo parametro può essere NULL, nel qual caso il parametro channelPropertyCount deve essere 0 (zero).

Nota Prestare molta attenzione alla modifica dei valori predefiniti per queste proprietà.

[in] channelPropertyCount

Numero di proprietà nella matrice channelProperties .

serviceProxy

In caso di esito positivo, un puntatore che riceve l'indirizzo della struttura WS_SERVICE_PROXY che rappresenta il nuovo proxy del servizio.

Quando questa struttura non è più necessaria, è necessario liberarla chiamando WsFreeServiceProxy.

[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
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Requisiti


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