Função WsCreateServiceHost (webservices.h)

Artigo
03/03/2024

Cria um host de serviço para os pontos de extremidade especificados.

Sintaxe

HRESULT WsCreateServiceHost(
                 const WS_SERVICE_ENDPOINT **endpoints,
  [in]           const USHORT              endpointCount,
                 const WS_SERVICE_PROPERTY *serviceProperties,
  [in]           ULONG                     servicePropertyCount,
                 WS_SERVICE_HOST           **serviceHost,
  [in, optional] WS_ERROR                  *error
);

Parâmetros

endpoints

Uma matriz de estruturas de WS_SERVICE_ENDPOINT que representam os pontos de extremidade de serviço para os quais criar o host de serviço.

[in] endpointCount

O número de pontos de extremidade na matriz de pontos de extremidade .

serviceProperties

Uma matriz de estruturas de WS_SERVICE_PROPERTY que contêm propriedades opcionais para o host de serviço.

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

[in] servicePropertyCount

O número de propriedades na matriz serviceProperties .

serviceHost

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

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

[in, optional] error

Ponteiro para uma estrutura de 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 retorna um código de erro HRESULT.

Código de retorno	Descrição
E_INVALIDARG	Um argumento inválido é especificado para criar o host de serviço.
WS_E_QUOTA_EXCEEDED	Uma cota foi excedida.
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.
Outros erros	Essa função pode retornar outros erros não listados acima.

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

Share via