LPNSPV2STARTUP função de retorno de chamada (ws2spi.h)

Artigo
08/28/2023

A função NSPv2Startup notifica um provedor de provedor de serviços de namespace versão 2 (NSPv2) de que um novo processo de cliente deve começar a usar o provedor.

Sintaxe

LPNSPV2STARTUP Lpnspv2startup;

INT Lpnspv2startup(
  [in] LPGUID lpProviderId,
  [in] LPVOID *ppvClientSessionArg
)
{...}

Parâmetros

[in] lpProviderId

Um ponteiro para o GUID do provedor de namespace específico a ser notificado.

[in] ppvClientSessionArg

Um ponteiro para a sessão do cliente.

Retornar valor

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

Código do erro	Significado
WSA_NOT_ENOUGH_MEMORY	Não há memória suficiente disponível para executar essa operação.
WSAEACCES	A rotina de chamada não tem privilégios suficientes para inicializar o serviço.
WSAEINVAL	Um ou mais parâmetros eram inválidos ou ausentes para esse provedor.
WSAEOPNOTSUPP	A operação não tem suporte. Esse erro será retornado se o provedor de namespace não implementar essa função.
WSASERVICE_NOT_FOUND	O serviço é desconhecido. O serviço não pode ser encontrado no namespace especificado.

Comentários

A função NSPv2Startup é usada como parte da arquitetura do provedor de serviços de namespace versão 2 (NSPv2) disponível no Windows Vista e posterior.

No Windows Vista e no Windows Server 2008, a função NSPv2Startup só pode ser usada para operações em provedores de namespace NS_EMAIL.

A função NSPv2Startup é chamada sempre que um novo processo de cliente começa a usar o provedor de namespace. Os provedores podem usar o argumento de sessão do cliente apontado pelo parâmetro ppvClientSessionArg para armazenar informações sobre essa sessão. O valor no parâmetro ppvClientSessionArg será passado para chamadas de função NSPv2 subsequentes na mesma sessão. O argumento de sessão do cliente poderá NULL, se o provedor de namespace não exigir essas informações.

A função NSPv2Startup é chamada quando uma nova sessão de cliente é inicializada. As funções NSPv2Startup e NSPv2Cleanup devem ser chamadas como pares.

A função NSPv2Startup deve ser chamada com êxito antes de chamar a função NSPv2Cleanup . É permitido fazer mais de uma chamada NSPv2Startup . No entanto, para cada chamada NSPv2Startup , uma chamada NSPv2Cleanup correspondente também deve ser emitida. Somente o NSPv2Cleanup final para o provedor de serviços faz a limpeza real; as chamadas anteriores decrementam uma contagem de referência interna no provedor de serviços de namespace.

As funções NSPv2Startup, NSPv2ClientSessionRundown e NSPv2Cleanup são opcionais, dependendo dos requisitos do provedor NSPv2.

Se a função NSPv2Startup não for implementada, as chamadas para essa função deverão ser interceptadas por uma função stub que retorna WSAEOPNOTSUPP. O ponteiro da função NSPv2 para a função NSPv2Startup não implementada na estrutura NSPV2_ROUTINE deve apontar para a função stub.

Requisitos

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