Função WSADuplicateSocketW (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 WSADuplicateSocketW(
  [in]  SOCKET              s,
  [in]  DWORD               dwProcessId,
  [out] LPWSAPROTOCOL_INFOW 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 de WSAPROTOCOL_INFO. O provedor de serviços copia o conteúdo da estrutura de informações de protocolo para esse buffer.

Valor de retorno

Se nenhum erro ocorrer, WSADuplicateSocket retornará zero. Caso contrário, um valor de SOCKET_ERROR será retornado e um código de erro específico poderá ser recuperado chamando WSAGetLastError.

Observações

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.

Os 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.

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 de setsockopt executada usando um descritor é subsequentemente visível usando um de getsockopt de qualquer um ou de 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 soquete para criar o soquete, o processo de destino deverá passar o sinalizador de WSA_FLAG_OVERLAPPED para sua chamada de função WSASocket. Um processo pode chamar closesocket em um soquete duplicado e o descritor será desalocado. O soquete subjacente, no entanto, permanecerá aberto até que fechamento 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 no Windows 8.1, Windows Server 2012 R2 e posterior.

Requisitos

Consulte também

WSASocket

do Winsock Functions

referência Winsock