Función de devolución de llamada LPWSPDUPLICATESOCKET (ws2spi.h)
La función LPWSPDuplicateSocket
Sintaxis
LPWSPDUPLICATESOCKET Lpwspduplicatesocket;
int Lpwspduplicatesocket(
[in] SOCKET s,
[in] DWORD dwProcessId,
[out] LPWSAPROTOCOL_INFOW lpProtocolInfo,
[out] LPINT lpErrno
)
{...}
Parámetros
[in] s
Descriptor de socket local.
[in] dwProcessId
Identificador del proceso de destino para el que se usará el socket compartido.
[out] lpProtocolInfo
Puntero a un búfer asignado por el cliente lo suficientemente grande como para contener una estructura de WSAPROTOCOL_INFO. El proveedor de servicios copia el contenido de la estructura de información del protocolo en este búfer.
[out] lpErrno
Puntero al código de error.
Valor devuelto
Si no se produce ningún error, LPWSPDuplicateSocket devuelve cero. De lo contrario, se devuelve el valor de SOCKET_ERROR y hay disponible un número de error específico en lpErrno.
| Código de error | Significado |
|---|---|
| Error en el subsistema de red. | |
| Indica que uno de los parámetros especificados no era válido. | |
| Bloquear la llamada a Windows Sockets está en curso o el proveedor de servicios sigue procesando una función de devolución de llamada. | |
| No hay más descriptores de socket disponibles. | |
| No hay espacio de búfer disponible. No se puede crear el socket. | |
| El descriptor no es un socket. |
Observaciones
Un proceso de origen llama a LPWSPDuplicateSocket para obtener una estructura de WSAPROTOCOL_INFO especial. Usa algún mecanismo de comunicaciones entre procesos (IPC) para pasar el contenido de esta estructura a un proceso de destino, que a su vez lo usa en una llamada a LPWSPSocket para obtener un descriptor para el socket duplicado. Tenga en cuenta que el proceso de destino solo puede usar la estructura WSAPROTOCOL_INFO especial una vez.
Es responsabilidad del proveedor de servicios realizar las operaciones necesarias en el contexto del proceso de origen y crear una estructura de WSAPROTOCOL_INFO que se reconocerá cuando aparezca posteriormente como parámetro para LPWSPSocket en el contexto de los procesos de destino. A continuación, el proveedor debe devolver un descriptor de socket que haga referencia a un socket subyacente común. El miembro dwProviderReserved de la estructura WSAPROTOCOL_INFO está disponible para el uso del proveedor de servicios y se puede usar para almacenar cualquier información de contexto útil, incluido un identificador duplicado.
Cuando se asigna un nuevo descriptor de socket, un proveedor de sistema de archivos (IFS) instalable debe llamar a WPUModifyIFSHandley un proveedor que no sea IFS debe llamar a WPUCreateSocketHandle. Un proveedor IFS puede usar la función DuplicateHandle. Para garantizar la correcta ejecución de la duplicación de sockets, un proveedor de servicios que no sea IFS debe usar la función LPWSPDuplicateSocket.
En el siguiente ejemplo se muestra un escenario posible para establecer y usar un socket compartido en modo de entrega.
| Proceso de origen | IPC | Significado |
|---|---|---|
|
==> | |
|
|
3) Recibe la solicitud de identificador de proceso y responde. | |
|
<== | |
|
||
|
||
|
|
==> | 7) Recibe WSAPROTOCOL_INFO estructura. |
|
|
8) Llama a LPWSPSocket para crear un descriptor de socket compartido. | |
|
|
9) Usa socket compartido para el intercambio de datos. | |
|
<== |
Los descriptores que hacen referencia a un socket compartido se pueden usar de forma independiente en lo que respecta a la E/S. Sin embargo, la interfaz de Windows Sockets no implementa ningún tipo de control de acceso, por lo que depende de los procesos implicados coordinar sus operaciones en un socket compartido. Un uso típico para sockets compartidos es tener un proceso responsable de crear sockets y establecer conexiones, entregar sockets a otros procesos responsables del intercambio de información.
Dado que lo que se duplica son los descriptores de socket y no el socket subyacente, todos los estados asociados a un socket se mantienen en común en todos los descriptores. Por ejemplo, una operación de WSPSetSockOpt realizada mediante un descriptor se puede ver posteriormente mediante un LPWSPGetSockopt desde cualquiera o todos los descriptores. Un proceso puede llamar a LPWSPCloseSocket en un socket duplicado y el descriptor se desasignará. Sin embargo, el socket subyacente permanecerá abierto hasta que el último descriptor restante llame a LPWSPClosesocket.
La notificación en sockets compartidos está sujeta a las restricciones habituales de LPWSPAsyncSelect y LPWSPEventSelect. La emisión de cualquiera de estas llamadas mediante cualquiera de los descriptores compartidos cancela cualquier registro de eventos anterior para el socket, independientemente del descriptor que se usó para realizar ese registro. Por lo tanto, por ejemplo, un socket compartido no puede entregar FD_READ eventos para procesar eventos A y FD_WRITE para procesar B. En situaciones en las que se requiere una coordinación estrecha, se recomienda que los desarrolladores usen subprocesos en lugar de procesos independientes.
Un proveedor de servicios en capas proporciona una implementación de esta función, pero también es un cliente de esta función si y cuando llama a LPWSPDuplicateSocket de la siguiente capa de la cadena de protocolos. Algunas consideraciones especiales se aplican al parámetro de lpProtocolInfo de esta función, ya que se propaga a través de las capas de la cadena de protocolos.
Si la siguiente capa de la cadena de protocolos es otra capa, cuando se llama al LPWSPDuplicateSocket de la capa siguiente, esta capa debe pasar a la siguiente capa una lpProtocolInfo que haga referencia a la misma estructura de WSAPROTOCOL_INFO sin modificar con la misma información de cadena sin modificar. Sin embargo, si la capa siguiente es el protocolo base (es decir, el último elemento de la cadena), esta capa realiza una sustitución al llamar al proveedor base de LPWSPDuplicateSocket. En este caso, el parámetro lpProtocolInfo debe hacer referencia a la estructura WSAPROTOCOL_INFO del proveedor base.
Una ventaja fundamental de esta directiva es que los proveedores de servicios base no tienen que ser conscientes de las cadenas de protocolo. Esta misma directiva se aplica al propagar una estructura de WSAPROTOCOL_INFO a través de una secuencia superpuesta de otras funciones, como LPWSPAddressToString, WSPStartup, LPWSPSocketo LPWSPStringToAddress.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| encabezado de |
ws2spi.h |