Compartir a través de

Función WsCreateServiceEndpointFromTemplate (webservices.h)

  • Artículo

Rutina auxiliar para crear un punto de conexión de servicio (WS_SERVICE_ENDPOINT) a partir de plantillas de directiva.

Sintaxis

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

Parámetros

[in] channelType

Valor de enumeración WS_CHANNEL_TYPE que representa el tipo de canal hospedado por el punto de conexión.

[in] properties

Matriz de estructuras de WS_SERVICE_ENDPOINT_PROPERTY que contienen propiedades para el punto de conexión de servicio. (La aplicación debe rellenar las propiedades del canal en la estructura de la plantilla).

[in] propertyCount

Número de propiedades de la matriz de propiedades .

[in, optional] addressUrl

Dirección URL en la que se va a escuchar el punto de conexión.

[in] contract

Estructura WS_SERVICE_CONTRACT que representa el contrato del punto de conexión.

[in] authorizationCallback

Devolución de llamada de autorización WS_SERVICE_SECURITY_CALLBACK para el punto de conexión de servicio.

[in] heap

El montón desde el que se asigna memoria para el punto de conexión de servicio cuando se devuelve correctamente.

[in] templateType

Valor de enumeración WS_BINDING_TEMPLATE_TYPE que representa el tipo de plantillas que se usan para crear el punto de conexión de servicio.

[in] templateValue

Estructura de plantilla opcional que se va a crear y rellenar por aplicación. La plantilla debe ser coherente con el tipo de plantilla de entrada (pasado en el parámetro templateType ). Cuando el parámetro templateValue es NULL, equivale a la estructura de plantilla correspondiente inicializada en cero.

[in] templateSize

Tamaño, en bytes, de la estructura templateValue de entrada.

[in] templateDescription

Descripción de la estructura de plantilla (pasada en el parámetro templateValue ). Debe coincidir con templateType.

[in] templateDescriptionSize

Tamaño de la descripción de la plantilla.

[out] serviceEndpoint

Si se ejecuta correctamente, un puntero que recibe la dirección de la estructura de WS_SERVICE_ENDPOINT que representa el nuevo punto de conexión de servicio.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Comentarios

WsCreateServiceEndpointFromTemplate crea la estructura de WS_SERVICE_ENDPOINT a partir de las plantillas de directiva de entrada especificadas y la entrada de usuario adicional.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll