Поделиться через

Функция WSAProviderCompleteAsyncCall (ws2spi.h)

  • Статья

Функция WSAProviderCompleteAsyncCall уведомляет клиента о завершении асинхронного вызова поставщика пространства имен версии 2.

Синтаксис

INT WSAAPI WSAProviderCompleteAsyncCall(
  HANDLE hAsyncCall,
  INT    iRetCode
);

Параметры

hAsyncCall

Дескриптор, передаваемый завершенным асинхронным вызовом. Этот дескриптор передается клиентом поставщику пространства имен версии 2 в асинхронном вызове функции.

iRetCode

Код возврата для асинхронного вызова поставщика пространства имен версии 2.

Возвращаемое значение

Если ошибка не возникает, WSAProviderCompleteAsyncCall возвращает ноль.

Если функция завершается сбоем, возвращаемое значение SOCKET_ERROR. Чтобы получить расширенные сведения об ошибке, вызовите WSAGetLastError, который возвращает одно из следующих расширенных значений ошибки.

Код ошибки Значение
WSA_NOT_ENOUGH_MEMORY
 Недостаточно памяти для выполнения операции.
WSAEFAULT
 Внутренняя ошибка.
WSAEINVAL
 Недопустимый параметр. Эта ошибка возвращается, если параметр hAsyncCall имеет значение **NULL**.
WSANOTINITIALISED
 Ws2_32.dll не инициализирована. Приложение должно сначала вызвать WSAStartup , прежде чем вызывать какие-либо функции windows Sockets.

Комментарии

Функция WSAProviderCompleteAsyncCall используется как часть архитектуры поставщика службы пространства имен версии 2 (NSPv2), доступной в Windows Vista и более поздних версиях.

В Windows Vista и Windows Server 2008 функцию WSAUnadvertiseProvider можно использовать только для операций с поставщиками NS_EMAIL пространств имен. Асинхронные вызовы поставщиков NSPv2 не поддерживаются в Windows Vista и Windows Server 2008. Поэтому WSAProviderCompleteAsyncCall в настоящее время неприменимо. Эта функция планируется использовать в более поздних версиях Windows, если поддерживаются асинхронные вызовы поставщиков пространств имен.

Как правило, поставщики NSPv2 реализуются в процессах, отличных от вызывающих приложений. Поставщики NSPv2 не активируются в результате действий клиента. Каждое приложение поставщика, размещающее поставщик, решает, когда следует сделать конкретный поставщик доступным или недоступным, путем вызова функций WSAAdvertiseProvider и WSAUnadvertiseProvider . Действие клиента приводит к попыткам связаться с поставщиком только при наличии (при объявлении поставщика пространства имен).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header ws2spi.h
Библиотека Ws2_32.lib
DLL Ws2_32.dll

См. также раздел

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAGetLastError

WSAUnadvertiseProvider