Función WsOpenServiceProxy (webservices.h)

Abre un proxy de servicio en un punto de conexión de servicio.

Si las aplicaciones cliente se realizan correctamente, pueden realizar llamadas mediante el proxy de servicio. El comportamiento de WsOpenServiceProxy se rige por el enlace de canal usado.

Sintaxis

HRESULT WsOpenServiceProxy(
  [in]           WS_SERVICE_PROXY          *serviceProxy,
  [in]           const WS_ENDPOINT_ADDRESS *address,
  [in, optional] const WS_ASYNC_CONTEXT    *asyncContext,
  [in, optional] WS_ERROR                  *error
);

Parámetros

[in] serviceProxy

Puntero al proxy de servicio que se va a abrir. El puntero debe hacer referencia a un objeto WS_SERVICE_PROXY válido y el valor al que se hace referencia no puede ser NULL.

[in] address

Puntero a la dirección del punto de conexión.

[in, optional] asyncContext

Puntero a un objeto WS_ASYNC_CONTEXT que tiene información sobre cómo invocar la función de forma asincrónica. El valor se establece en NULL si se invoca de forma sincrónica.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
WS_S_ASYNC	La operación asincrónica sigue pendiente.
WS_E_OPERATION_ABORTED	Se anuló la operación.
WS_E_INVALID_OPERATION	No se permite la operación debido al estado actual del objeto .
WS_E_ENDPOINT_NOT_FOUND	El punto de conexión remoto no existe o no se pudo encontrar.
WS_E_ENDPOINT_ACCESS_DENIED	El punto de conexión remoto denegó el acceso.
WS_E_ENDPOINT_DISCONNECTED	Se finalizó la conexión con el punto de conexión remoto.
WS_E_ENDPOINT_FAILURE	El punto de conexión remoto no pudo procesar la solicitud.
WS_E_ENDPOINT_NOT_AVAILABLE	El punto de conexión remoto no está actualmente en servicio en esta ubicación.
WS_E_ENDPOINT_TOO_BUSY	El punto de conexión remoto no puede procesar la solicitud debido a que se ha sobrecargado.
WS_E_ENDPOINT_UNREACHABLE	No se pudo acceder al punto de conexión remoto.
WS_E_INVALID_ENDPOINT_URL	La dirección URL del punto de conexión no es válida.
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
WS_E_OPERATION_TIMED_OUT	La operación no se completó dentro del tiempo asignado.
WS_E_PROXY_ACCESS_DENIED	El servidor proxy HTTP denegó el acceso.
WS_E_PROXY_FAILURE	El servidor proxy HTTP no pudo procesar la solicitud.
WS_E_QUOTA_EXCEEDED	Se superó una cuota.
WS_E_SECURITY_VERIFICATION_FAILURE	La comprobación de seguridad no se realizó correctamente para los datos recibidos.
WS_E_SECURITY_SYSTEM_FAILURE	Error en una operación de seguridad en el marco de servicios web de Windows.
WS_E_PROXY_REQUIRES_BASIC_AUTH	El servidor proxy HTTP requiere el esquema de autenticación HTTP "básico".
WS_E_PROXY_REQUIRES_DIGEST_AUTH	El servidor proxy HTTP requiere el esquema de autenticación HTTP "digest".
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH	El servidor proxy HTTP requiere el esquema de autenticación HTTP "negotiate".
WS_E_PROXY_REQUIRES_NTLM_AUTH	El servidor proxy HTTP requiere el esquema de autenticación HTTP "NTLM".
WS_E_SERVER_REQUIRES_BASIC_AUTH	El punto de conexión remoto requiere el esquema de autenticación HTTP "basic".
WS_E_SERVER_REQUIRES_DIGEST_AUTH	El punto de conexión remoto requiere el esquema de autenticación HTTP "digest".
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH	El punto de conexión remoto requiere el esquema de autenticación HTTP "negotiate".
WS_E_SERVER_REQUIRES_NTLM_AUTH	El punto de conexión remoto requiere el esquema de autenticación HTTP "NTLM".
E_OUTOFMEMORY	Se quedó sin memoria.
E_INVALIDARG	Uno o más argumentos no son válidos.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

Requisitos

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