Função WsCreateServiceProxy (webservices.h)

Artigo
08/27/2023

Cria um proxy de serviço com as propriedades especificadas.

Sintaxe

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 WS_SERVICE_PROXY              **serviceProxy,
  [in, optional] WS_ERROR                      *error
);

Parâmetros

[in] channelType

Um WS_CHANNEL_TYPE valor de enumeração que representa o tipo de canal para o proxy de serviço.

[in] channelBinding

Um valor de enumeração WS_CHANNEL_BINDING que representa a associação de canal.

[in, optional] securityDescription

Uma estrutura WS_SECURITY_DESCRIPTION que representa a descrição de segurança.

properties

Uma matriz de estruturas de WS_PROXY_PROPERTY que contêm propriedades opcionais para o proxy de serviço.

O valor desse parâmetro pode ser NULL, nesse caso, o parâmetro propertyCount deve ser 0 (zero).

[in] propertyCount

O número de propriedades na matriz de propriedades .

channelProperties

Uma matriz de estruturas de WS_CHANNEL_PROPERTY que contém propriedades opcionais do canal. O valor desse parâmetro pode ser NULL, nesse caso, o parâmetro channelPropertyCount deve ser 0 (zero).

Nota Tenha muito cuidado ao modificar os valores padrão dessas propriedades.

[in] channelPropertyCount

O número de propriedades na matriz channelProperties .

serviceProxy

Em caso de êxito, um ponteiro que recebe o endereço da estrutura WS_SERVICE_PROXY que representa o novo proxy de serviço.

Quando você não precisar mais dessa estrutura, deverá liberá-la chamando WsFreeServiceProxy.

[in, optional] error

Ponteiro para uma estrutura de WS_ERROR que recebe informações de erro adicionais se a função falhar.

Valor retornado

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retorna um código de erro HRESULT.

Código de retorno	Descrição
E_INVALIDARG	Um ou mais argumentos são inválidos.
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.
Outros erros	Essa função pode retornar outros erros não listados acima.

Requisitos


Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	webservices.h
Biblioteca	WebServices.lib
DLL	WebServices.dll

Share via