Função WSAProviderCompleteAsyncCall (ws2spi.h)

  • Artigo

A função WSAProviderCompleteAsyncCall notifica um cliente quando uma chamada assíncrona para um provedor de namespace versão 2 é concluída.

Sintaxe

INT WSAAPI WSAProviderCompleteAsyncCall(
  HANDLE hAsyncCall,
  INT    iRetCode
);

Parâmetros

hAsyncCall

O identificador passado para a chamada assíncrona que está sendo concluída. Esse identificador é passado pelo cliente para o provedor de namespace versão 2 na chamada de função assíncrona.

iRetCode

O código de retorno para a chamada assíncrona para o provedor de namespace versão 2.

Retornar valor

Se nenhum erro ocorrer, WSAProviderCompleteAsyncCall retornará zero.

Se a função falhar, o valor retornado será SOCKET_ERROR. Para obter informações de erro estendidas, chame WSAGetLastError, que retorna um dos seguintes valores de erro estendidos.

Código do erro Significado
WSA_NOT_ENOUGH_MEMORY
 Não havia memória suficiente para executar a operação.
WSAEFAULT
 Ocorreu um erro interno.
WSAEINVAL
 Um parâmetro não era válido. Esse erro será retornado se o parâmetro hAsyncCall for **NULL**.
WSANOTINITIALISED
 O Ws2_32.dll não foi inicializado. O aplicativo deve primeiro chamar WSAStartup antes de chamar qualquer função do Windows Sockets.

Comentários

A função WSAProviderCompleteAsyncCall é 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 WSAUnadvertiseProvider só pode ser usada para operações em provedores de namespace NS_EMAIL. Não há suporte para chamadas assíncronas para provedores NSPv2 no Windows Vista e no Windows Server 2008. Portanto, o WSAProviderCompleteAsyncCall não é aplicável no momento. Essa função está planejada para uso em versões posteriores do Windows quando há suporte para chamadas assíncronas para provedores de namespace.

Em geral, os provedores NSPv2 são implementados em processos diferentes dos aplicativos de chamada. Os provedores NSPv2 não são ativados como resultado da atividade do cliente. Cada aplicativo de hospedagem do provedor decide quando disponibilizar ou não um provedor específico chamando as funções WSAAdvertiseProvider e WSAUnadvertiseProvider . A atividade do cliente só resulta em tentativas de entrar em contato com o provedor, quando disponível (quando o provedor de namespace é anunciado).

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
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

NSPV2_ROUTINE

WSAAdvertiseProvider

Wsagetlasterror

WSAUnadvertiseProvider