Funzione WsCreateServiceEndpointFromTemplate (webservices.h)

Articolo
08/27/2023

Routine helper per la creazione di un endpoint di servizio (WS_SERVICE_ENDPOINT) dai modelli di criteri.

Sintassi

HRESULT WsCreateServiceEndpointFromTemplate(
  [in]           WS_CHANNEL_TYPE                    channelType,
  [in]           const WS_SERVICE_ENDPOINT_PROPERTY *properties,
  [in]           ULONG                              propertyCount,
  [in, optional] const WS_STRING                    *addressUrl,
  [in]           const WS_SERVICE_CONTRACT          *contract,
  [in]           WS_SERVICE_SECURITY_CALLBACK       authorizationCallback,
  [in]           WS_HEAP                            *heap,
  [in]           WS_BINDING_TEMPLATE_TYPE           templateType,
  [in]           void                               *templateValue,
  [in]           ULONG                              templateSize,
  [in]           const void                         *templateDescription,
  [in]           ULONG                              templateDescriptionSize,
  [out]          WS_SERVICE_ENDPOINT                **serviceEndpoint,
  [in, optional] WS_ERROR                           *error
);

Parametri

[in] channelType

Valore di enumerazione WS_CHANNEL_TYPE che rappresenta il tipo di canale ospitato dall'endpoint.

[in] properties

Matrice di strutture WS_SERVICE_ENDPOINT_PROPERTY contenenti proprietà per l'endpoint del servizio. L'applicazione deve compilare le proprietà del canale nella struttura del modello.

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

[in, optional] addressUrl

Indirizzo URL in cui l'endpoint deve essere in ascolto.

[in] contract

Struttura WS_SERVICE_CONTRACT che rappresenta il contratto dell'endpoint.

[in] authorizationCallback

Callback di autorizzazione WS_SERVICE_SECURITY_CALLBACK per l'endpoint del servizio.

[in] heap

Heap da cui viene allocata la memoria per l'endpoint del servizio in caso di esito positivo.

[in] templateType

Valore di enumerazione WS_BINDING_TEMPLATE_TYPE che rappresenta il tipo di modelli usati per creare l'endpoint del servizio.

[in] templateValue

Struttura del modello facoltativa da creare e compilare in base all'applicazione. Il modello deve essere coerente con il tipo di modello di input (passato nel parametro templateType ). Quando il parametro templateValue è NULL, equivale alla struttura del modello corrispondente inizializzata su zero.

[in] templateSize

Dimensioni, in byte, della struttura templateValue di input.

[in] templateDescription

Descrizione della struttura del modello (passata nel parametro templateValue ). Deve corrispondere al modelloType.

[in] templateDescriptionSize

Dimensioni della descrizione del modello.

[out] serviceEndpoint

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

[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

WsCreateServiceEndpointFromTemplate crea la struttura WS_SERVICE_ENDPOINT dai modelli di criteri di input specificati e dall'input utente aggiuntivo.

Requisiti

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

Condividi tramite