Función WSAProviderCompleteAsyncCall (ws2spi.h)
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 |
|---|---|
| No había memoria suficiente para realizar la operación. | |
| Se ha producido un error interno. | |
| Un parámetro no era válido. Este error se devuelve si el parámetro hAsyncCall era **NULL**. | |
| 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 |