Função GetAcceptExSockaddrs (winsock.h)

Artigo
08/27/2023

A função GetAcceptExSockaddrs analisa os dados obtidos de uma chamada para a função AcceptEx e passa os endereços locais e remotos para uma estrutura sockaddr .

Nota Essa função é uma extensão específica da Microsoft para a especificação do Windows Sockets.

Sintaxe

void GetAcceptExSockaddrs(
  [in]  PVOID    lpOutputBuffer,
  [in]  DWORD    dwReceiveDataLength,
  [in]  DWORD    dwLocalAddressLength,
  [in]  DWORD    dwRemoteAddressLength,
  [out] sockaddr **LocalSockaddr,
  [out] LPINT    LocalSockaddrLength,
  [out] sockaddr **RemoteSockaddr,
  [out] LPINT    RemoteSockaddrLength
);

Parâmetros

[in] lpOutputBuffer

Um ponteiro para um buffer que recebe o primeiro bloco de dados enviado em uma conexão resultante de uma chamada AcceptEx . Deve ser o mesmo parâmetro lpOutputBuffer que foi passado para a função AcceptEx .

[in] dwReceiveDataLength

O número de bytes no buffer usado para receber os primeiros dados. Esse valor deve ser igual ao parâmetro dwReceiveDataLength que foi passado para a função AcceptEx .

[in] dwLocalAddressLength

O número de bytes reservados para as informações de endereço local. Esse valor deve ser igual ao parâmetro dwLocalAddressLength que foi passado para a função AcceptEx .

[in] dwRemoteAddressLength

O número de bytes reservados para as informações de endereço remoto. Esse valor deve ser igual ao parâmetro dwRemoteAddressLength que foi passado para a função AcceptEx .

[out] LocalSockaddr

Um ponteiro para a estrutura sockaddr que recebe o endereço local da conexão (as mesmas informações que seriam retornadas pela função getsockname ). Esse parâmetro precisa ser especificado.

[out] LocalSockaddrLength

O tamanho, em bytes, do endereço local. Esse parâmetro precisa ser especificado.

[out] RemoteSockaddr

Um ponteiro para a estrutura sockaddr que recebe o endereço remoto da conexão (as mesmas informações que seriam retornadas pela função getpeername ). Esse parâmetro precisa ser especificado.

[out] RemoteSockaddrLength

O tamanho, em bytes, do endereço local. Esse parâmetro precisa ser especificado.

Retornar valor

Nenhum

Comentários

A função GetAcceptExSockaddrs é usada exclusivamente com a função AcceptEx para analisar os primeiros dados que o soquete recebe em endereços locais e remotos. A função AcceptEx retorna informações de endereço local e remoto em um formato interno. Os desenvolvedores de aplicativos precisarão usar a função GetAcceptExSockaddrs se houver necessidade das estruturas sockaddr que contêm os endereços locais ou remotos.

Nota O ponteiro de função para a função GetAcceptExSockaddrs deve ser obtido em tempo de execução fazendo uma chamada para a função WSAIoctl com o SIO_GET_EXTENSION_FUNCTION_POINTER opcode especificado. O buffer de entrada passado para a função WSAIoctl deve conter WSAID_GETACCEPTEXSOCKADDRS, um GUID (identificador global exclusivo) cujo valor identifica a função de extensão GetAcceptExSockaddrs . Em caso de êxito, a saída retornada pela função WSAIoctl contém um ponteiro para a função GetAcceptExSockaddrs . O GUID WSAID_GETACCEPTEXSOCKADDRS é definido no arquivo de cabeçalho Mswsock.h .

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito	Valor
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	winsock.h (inclua Mswsock.h)
Biblioteca	Mswsock.lib
DLL	Mswsock.dll