Compartilhar via


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

A função NSPv2ClientSessionRundown notifica um provedor de provedor de serviços de namespace versão 2 (NSPv2) de que a sessão do cliente está terminando.

Sintaxe

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

void Lpnspv2clientsessionrundown(
  [in] LPGUID lpProviderId,
  [in] LPVOID pvClientSessionArg
)
{...}

Parâmetros

[in] lpProviderId

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

[in] pvClientSessionArg

Um ponteiro para a sessão do cliente que está terminando.

Valor retornado

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 instalar 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. Esse erro também poderá ser retornado se o dwControlCode especificado for um comando não reconhecido.
WSASERVICE_NOT_FOUND
O serviço é desconhecido. O serviço não pode ser encontrado no namespace especificado.

Comentários

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

No Windows Vista e no Windows Server 2008, a função NSPv2ClientSessionRundown 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. Se um valor tiver sido especificado para o argumento de sessão do cliente na chamada para a função NSPv2Startup , esse mesmo argumento de sessão do cliente será passado no parâmetro pvClientSessionArg para a função NSPv2ClientSessionRundown .

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

Se a função NSPv2ClientSessionRundown 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 NSPv2ClientSessionRundown não simplificada na estrutura NSPV2_ROUTINE deve apontar para a função stub.

Requisitos

   
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

Confira também

NSPV2_ROUTINE

NSPv2Cleanup

NSPv2LookupServiceBegin

NSPv2LookupServiceEnd

NSPv2LookupServiceNextEx

NSPv2SetServiceEx

NSPv2Startup

WSAQUERYSET2

WSASetLastError