Compartilhar via

Função WsCreateServiceEndpointFromTemplate (webservices.h)

  • Artigo

Rotina auxiliar para criar um ponto de extremidade de serviço (WS_SERVICE_ENDPOINT) a partir de modelos de política.

Sintaxe

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

Um WS_CHANNEL_TYPE valor de enumeração que representa o tipo de canal hospedado pelo ponto de extremidade.

[in] properties

Uma matriz de estruturas WS_SERVICE_ENDPOINT_PROPERTY que contêm propriedades para o ponto de extremidade de serviço. (O aplicativo deve preencher as propriedades do canal na estrutura do modelo.)

[in] propertyCount

O número de propriedades na matriz de propriedades .

[in, optional] addressUrl

O endereço de URL no qual o ponto de extremidade deve escutar.

[in] contract

Uma estrutura WS_SERVICE_CONTRACT que representa o contrato do ponto de extremidade.

[in] authorizationCallback

Um WS_SERVICE_SECURITY_CALLBACK retorno de chamada de autorização para o ponto de extremidade de serviço.

[in] heap

O heap do qual a memória do ponto de extremidade de serviço é alocada no retorno bem-sucedido.

[in] templateType

Um WS_BINDING_TEMPLATE_TYPE valor de enumeração que representa o tipo de modelos que estão sendo usados para criar o ponto de extremidade de serviço.

[in] templateValue

Estrutura de modelo opcional a ser criada e preenchida pelo aplicativo. O modelo deve ser consistente com o tipo de modelo de entrada (passado no parâmetro templateType ). Quando o parâmetro templateValue é NULL, ele é equivalente à estrutura de modelo correspondente inicializada como zero.

[in] templateSize

O tamanho, em bytes, da estrutura templateValue de entrada.

[in] templateDescription

A descrição da estrutura do modelo (passada no parâmetro templateValue ). Precisa corresponder a templateType.

[in] templateDescriptionSize

O tamanho da descrição do modelo.

[out] serviceEndpoint

Em caso de êxito, um ponteiro que recebe o endereço da estrutura WS_SERVICE_ENDPOINT que representa o novo ponto de extremidade de serviço.

[in, optional] error

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

Retornar valor

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

Comentários

WsCreateServiceEndpointFromTemplate cria a estrutura WS_SERVICE_ENDPOINT com base nos modelos de política de entrada especificados e na entrada de usuário adicional.

Requisitos

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