Función WSAProviderCompleteAsyncCall (ws2spi.h)

  • Artículo

La función WSAProviderCompleteAsyncCall notifica a un cliente cuando se completa una llamada asincrónica a un proveedor de la versión 2 del espacio de nombres.

Sintaxis

INT WSAAPI WSAProviderCompleteAsyncCall(
  HANDLE hAsyncCall,
  INT    iRetCode
);

Parámetros

hAsyncCall

Identificador pasado a la llamada asincrónica que se está completando. El cliente pasa este identificador al proveedor de la versión 2 del espacio de nombres en la llamada de función asincrónica.

iRetCode

Código de retorno para la llamada asincrónica al proveedor de la versión 2 del espacio de nombres.

Valor devuelto

Si no se produce ningún error, WSAProviderCompleteAsyncCall devuelve cero.

Si se produce un error en la función, el valor devuelto es SOCKET_ERROR. Para obtener información de error extendida, llame a WSAGetLastError, que devuelve uno de los siguientes valores de error extendidos.

Código de error Significado
WSA_NOT_ENOUGH_MEMORY
 No había memoria suficiente para realizar la operación.
WSAEFAULT
 Se ha producido un error interno.
WSAEINVAL
 Un parámetro no era válido. Este error se devuelve si el parámetro hAsyncCall era **NULL**.
WSANOTINITIALISED
 No se ha inicializado el Ws2_32.dll . La aplicación debe llamar primero a WSAStartup antes de llamar a cualquier función de Windows Sockets.

Comentarios

La función WSAProviderCompleteAsyncCall se usa como parte de la arquitectura del proveedor de servicios de espacio de nombres versión 2 (NSPv2) disponible en Windows Vista y versiones posteriores.

En Windows Vista y Windows Server 2008, la función WSAUnadvertiseProvider solo se puede usar para las operaciones en proveedores de espacios de nombres de NS_EMAIL. Las llamadas asincrónicas a proveedores NSPv2 no se admiten en Windows Vista y Windows Server 2008. Por lo tanto, WSAProviderCompleteAsyncCall no es aplicable actualmente. Esta función está planeada para su uso en versiones posteriores de Windows cuando se admiten llamadas asincrónicas a proveedores de espacios de nombres.

En general, los proveedores NSPv2 se implementan en procesos distintos de las aplicaciones que llaman. Los proveedores NSPv2 no se activan como resultado de la actividad del cliente. Cada aplicación de hospedaje de proveedores decide cuándo hacer que un proveedor específico esté disponible o no disponible mediante una llamada a las funciones WSAAdvertiseProvider y WSAUnadvertiseProvider . La actividad de cliente solo produce intentos de ponerse en contacto con el proveedor, cuando está disponible (cuando se anuncia el proveedor de espacios de nombres).

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ws2spi.h
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

NSPV2_ROUTINE

WSAAdvertiseProvider

WSAGetLastError

WSAUnadvertiseProvider