Función WsCreateListener (webservices.h)

  • Artículo

Crea un agente de escucha con las propiedades especificadas.

Sintaxis

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

Parámetros

[in] channelType

Tipo de canal para el que escucha el agente de escucha. Para los tipos de canal, consulte la enumeración WS_CHANNEL_TYPE .

[in] channelBinding

Protocolo de canal para el agente de escucha. Para ver los posibles enlaces, consulte la enumeración WS_CHANNEL_BINDING .

properties

Puntero a una estructura de WS_LISTENER_PROPERTY que contiene propiedades opcionales para el agente de escucha.

Para obtener información sobre las propiedades que puede especificar al crear un agente de escucha, vea la enumeración WS_LISTENER_PROPERTY_ID .

Para obtener información sobre cómo crear un agente de escucha personalizado, vea la sección Comentarios.

[in] propertyCount

Número de propiedades de la matriz de propiedades .

[in, optional] securityDescription

Puntero a una estructura de WS_SECURITY_DESCRIPTION que especifica la seguridad del agente de escucha.

Si va a crear un canal personalizado (mediante el valor WS_CUSTOM_CHANNEL_BINDING de la enumeración WS_CHANNEL_BINDING ), la descripción de seguridad debe ser NULL. Consulte la sección Comentarios.

listener

Si se ejecuta correctamente, un puntero que recibe la dirección de la estructura de WS_LISTENER que representa el nuevo agente de escucha.

[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.

Código devuelto Descripción
WS_E_QUOTA_EXCEEDED
 Se superó una cuota.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.
E_INVALIDARG
 Uno o más argumentos no son válidos.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Al crear un agente de escucha personalizado (mediante el valor WS_CUSTOM_CHANNEL_BINDING de la enumeración WS_CHANNEL_BINDING ), solo puede especificar las siguientes propiedades de canal:

  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS
(Consulte la enumeración WS_LISTENER_PROPERTY_ID ). Si se requieren otras propiedades iniciales para crear el agente de escucha personalizado, especifíquelas mediante la propiedad WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS.

Para pasar información de seguridad a una implementación personalizada del agente de escucha, use el valor WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS de la enumeración WS_LISTENER_PROPERTY_ID .

Requisitos

   
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