Função de retorno de chamada LPNSPCLEANUP (ws2spi.h)

  • Artigo

A função NSPCleanup encerra o uso de um provedor de serviço de namespace específico do Windows Sockets.

Sintaxe

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

Parâmetros

[in] lpProviderId

Um ponteiro para o GUID do provedor de namespace a ser encerrado.

Retornar valor

Se nenhum erro ocorrer, nSPCleanup retornará um valor de NO_ERROR (zero). Caso contrário, SOCKET_ERROR (–1) será retornado e o provedor deverá 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.
WSAEINVAL O parâmetro lpProviderId não especifica um provedor válido.
WSAEOPNOTSUPP A operação não tem suporte. Esse erro será retornado se o provedor de namespace não implementar essa função.

Comentários

A função NSPCleanup é chamada quando um aplicativo é concluído usando um provedor de serviços de namespace do Windows Sockets. A função NSPCleanup desregista um provedor de namespace específico e permite que o provedor de serviços de transporte libere qualquer um dos recursos alocados do provedor de namespace.

A função NSPStartup deve ser chamada com êxito antes de usar qualquer provedor de namespace. É permitido fazer mais de uma chamada NSPStartup . No entanto, para cada chamada NSPStartup , uma chamada NSPCleanup correspondente também deve ser emitida. Somente o NSPCleanup 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.

Essa função não deve retornar até que a DLL do provedor de serviços de namespace possa ser descarregada da memória.

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