Função NSPStartup (ws2spi.h)

  • Artigo

A função NSPStartup recupera as informações dinâmicas sobre um provedor, como a lista de pontos de entrada de DLL.

Essa função é chamada pelo cliente após a inicialização. As funções NSPStartup e NSPCleanup devem ser chamadas como pares. Todas as funções NSP devem ser chamadas de dentro de um par NSPStartup/NSPCleanup . Não é necessário que as funções do WSC sejam chamadas de dentro de um par NSPStartup/NSPCleanup .

Sintaxe

INT WSAAPI NSPStartup(
  [in]  LPGUID        lpProviderId,
  [out] LPNSP_ROUTINE lpnspRoutines
);

Parâmetros

[in] lpProviderId

O provedor desejado do qual retornar os pontos de entrada.

[out] lpnspRoutines

Um ponteiro para uma estrutura NSP_ROUTINE que aponta para pontos de entrada do provedor se a chamada de função for bem-sucedida.

Retornar valor

A função deverá retornar NO_ERROR (zero) se a rotina for bem-sucedida. Ele deverá retornar SOCKET_ERROR (-1) se a função falhar e precisar definir o código de erro apropriado usando WSASetLastError.

Valor Descrição
WSA_NOT_ENOUGH_MEMORY
 Não há memória suficiente disponível para executar essa operação.
WSAEINVAL
 Um ou mais parâmetros eram inválidos ou ausentes para esse provedor.
WSAEINVALIDPROCTABLE
 A tabela de chamadas de procedimento é inválida.
WSAEOPNOTSUPP
 A operação não tem suporte. Esse erro será retornado se o provedor de namespace não implementar essa função.
WSASYSNOTREADY
 A função NSPStartup não pode operar no momento porque o sistema subjacente usado para fornecer serviços de rede está indisponível no momento.

Comentários

Para obter mais informações, consulte a estrutura NSP_ROUTINE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ws2spi.h

Confira também

Nspcleanup

NSP_ROUTINE

WSASetLastError