Função WSAProviderCompleteAsyncCall (ws2spi.h)
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 |
|---|---|
| Não havia memória suficiente para executar a operação. | |
| Ocorreu um erro interno. | |
| Um parâmetro não era válido. Esse erro será retornado se o parâmetro hAsyncCall for **NULL**. | |
| 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 |