Função WSADuplicateSocketA (winsock2.h)
A função WSADuplicateSocket retorna uma estrutura WSAPROTOCOL_INFO que pode ser usada para criar um descritor de soquete para um soquete compartilhado. A função WSADuplicateSocket não pode ser usada em um soquete habilitado para QOS.
Sintaxe
int WSAAPI WSADuplicateSocketA(
[in] SOCKET s,
[in] DWORD dwProcessId,
[out] LPWSAPROTOCOL_INFOA lpProtocolInfo
);
Parâmetros
[in] s
Descritor que identifica o soquete local.
[in] dwProcessId
Identificador de processo do processo de destino no qual o soquete duplicado será usado.
[out] lpProtocolInfo
Ponteiro para um buffer, alocado pelo cliente, que é grande o suficiente para conter uma estrutura WSAPROTOCOL_INFO . O provedor de serviços copia o conteúdo da estrutura de informações de protocolo para esse buffer.
Valor retornado
Se nenhum erro ocorrer, WSADuplicateSocket retornará zero. Caso contrário, um valor de SOCKET_ERROR é retornado e um código de erro específico pode ser recuperado chamando WSAGetLastError.
| Código do erro | Significado |
|---|---|
| Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função. | |
| O subsistema de rede falhou. | |
| Indica que um dos parâmetros especificados era inválido. | |
| Uma chamada do Windows Sockets 1.1 de bloqueio está em andamento ou o provedor de serviços ainda está processando uma função de retorno de chamada. | |
| Nenhum descritor de soquete disponível. | |
| Nenhum espaço de buffer disponível. O soquete não pode ser criado. | |
| O descritor não é um soquete. | |
| O parâmetro lpProtocolInfo não é uma parte válida do espaço de endereço do usuário. |
Comentários
A função WSADuplicateSocket é usada para habilitar o compartilhamento de soquete entre processos. Um processo de origem chama WSADuplicateSocket para obter uma estrutura de WSAPROTOCOL_INFO especial. Ele usa algum mecanismo de IPC (comunicações entre processos) para passar o conteúdo dessa estrutura para um processo de destino, que, por sua vez, o usa em uma chamada para WSASocket para obter um descritor para o soquete duplicado. A estrutura de WSAPROTOCOL_INFO especial só pode ser usada uma vez pelo processo de destino.
Soquetes podem ser compartilhados entre threads em um determinado processo sem usar a função WSADuplicateSocket porque um descritor de soquete é válido em todos os threads de um processo.
Um cenário possível para estabelecer e entregar um soquete compartilhado é ilustrado na tabela a seguir.
| Processo de origem | IPC | Processo de Destino |
|---|---|---|
| 1) WSASocket, WSAConnect | ||
| 2) Solicitar identificador de processo de destino | ==> | |
| 3) Receber solicitação do identificador de processo e responder | ||
| 4) Identificador de processo de recebimento | <== | |
| 5) Chame WSADuplicateSocket para obter uma estrutura de WSAPROTOCOL_INFO especial | ||
| 6) Enviar estrutura de WSAPROTOCOL_INFO para o destino | ||
| ==> | 7) Estrutura de WSAPROTOCOL_INFO de recebimento | |
| 8) Chame WSASocket para criar o descritor de soquete compartilhado. | ||
| 9) Usar soquete compartilhado para troca de dados | ||
| 10) closesocket | <== |
Os descritores que fazem referência a um soquete compartilhado podem ser usados independentemente para E/S. No entanto, a interface do Windows Sockets não implementa nenhum tipo de controle de acesso, portanto, cabe aos processos envolvidos coordenar suas operações em um soquete compartilhado. Os soquetes compartilhados normalmente são usados para ter um processo responsável por criar soquetes e estabelecer conexões e outros processos responsáveis pela troca de informações.
Todas as informações de estado associadas a um soquete são mantidas em comum em todos os descritores porque os descritores de soquete são duplicados e não o soquete real. Por exemplo, uma operação setsockopt executada usando um descritor é subsequentemente visível usando um getsockopt de qualquer ou todos os descritores. O processo de origem e o processo de destino devem passar os mesmos sinalizadores para suas respectivas chamadas de função WSASocket . Se o processo de origem usar a função de soquete para criar o soquete, o processo de destino deverá passar o sinalizador WSA_FLAG_OVERLAPPED para sua chamada de função WSASocket . Um processo pode chamar closesocket em um soquete duplicado e o descritor será desalocado. No entanto, o soquete subjacente permanecerá aberto até que closesocket seja chamado pelo último descritor restante.
A notificação em soquetes compartilhados está sujeita às restrições usuais de WSAAsyncSelect e WSAEventSelect. A emissão de qualquer uma dessas chamadas usando qualquer um dos descritores compartilhados cancela qualquer registro de evento anterior para o soquete, independentemente de qual descritor foi usado para fazer esse registro. Portanto, um soquete compartilhado não pode fornecer eventos FD_READ para processar eventos A e FD_WRITE para processar B. Para situações em que essa coordenação apertada é necessária, os desenvolvedores seriam aconselhados a usar threads em vez de processos separados.
Windows 8.1 e Windows Server 2012 R2: a função WSADuplicateSocketW tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posterior.
Observação
O cabeçalho winsock2.h define WSADuplicateSocket como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 8.1, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | winsock2.h |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |