Funzione WsCreateServiceProxyFromTemplate (webservices.h)

Routine helper per la creazione di un proxy di servizio dai modelli di criteri.

Sintassi

HRESULT WsCreateServiceProxyFromTemplate(
  [in]           WS_CHANNEL_TYPE          channelType,
                 const WS_PROXY_PROPERTY  *properties,
  [in]           const ULONG              propertyCount,
  [in]           WS_BINDING_TEMPLATE_TYPE templateType,
                 void                     *templateValue,
  [in]           ULONG                    templateSize,
  [in]           const void               *templateDescription,
  [in]           ULONG                    templateDescriptionSize,
                 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.

properties

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

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

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

[in] templateType

Valore di enumerazione WS_BINDING_TEMPLATE_TYPE che rappresenta il tipo di modelli usati per creare il proxy del servizio.

Per altre informazioni, vedere le osservazioni .

templateValue

Struttura del modello facoltativa da creare e compilare da un'applicazione. Questa struttura del modello deve essere coerente con il tipo di modello di input (nel modelloType). Quando il parametro templateValue è NULL, equivale alla struttura del modello corrispondente inizializzata su zero.

Per altre informazioni, vedere le osservazioni .

[in] templateSize

Dimensioni, in byte, della struttura del modello (nel parametro templateValue ).

[in] templateDescription

Descrizione di templateValue. Deve corrispondere al modelloType.

Per altre informazioni, vedere le osservazioni .

[in] templateDescriptionSize

Dimensioni della descrizione del modello.

serviceProxy

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

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

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni di errore aggiuntive 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.

Commenti

WsCreateServiceProxyFromTemplate crea la struttura WS_SERVICE_PROXY dai modelli di criteri di input e dall'input utente aggiuntivo.

Nella tabella seguente viene illustrato il mapping tra i valori templateType e i tipi di dati corrispondenti da usare in templateValue e templateDescription.

Requisiti