Funzione GetAcceptExSockaddrs (mswsock.h)

Articolo
02/29/2024

La funzione GetAcceptExSockaddrs analizza i dati ottenuti da una chiamata alla funzione AcceptEx e passa gli indirizzi locali e remoti a una struttura sockaddr .

Nota Questa funzione è un'estensione specifica di Microsoft per la specifica Windows Sockets.

Sintassi

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
);

Parametri

[in] lpOutputBuffer

Puntatore a un buffer che riceve il primo blocco di dati inviati in una connessione risultante da una chiamata AcceptEx . Deve essere lo stesso parametro lpOutputBuffer passato alla funzione AcceptEx .

[in] dwReceiveDataLength

Numero di byte nel buffer usato per ricevere i primi dati. Questo valore deve essere uguale al parametro dwReceiveDataLength passato alla funzione AcceptEx .

[in] dwLocalAddressLength

Numero di byte riservati alle informazioni sull'indirizzo locale. Questo valore deve essere uguale al parametro dwLocalAddressLength passato alla funzione AcceptEx .

[in] dwRemoteAddressLength

Numero di byte riservati alle informazioni sull'indirizzo remoto. Questo valore deve essere uguale al parametro dwRemoteAddressLength passato alla funzione AcceptEx .

[out] LocalSockaddr

Puntatore alla struttura sockaddr che riceve l'indirizzo locale della connessione (le stesse informazioni restituite dalla funzione getsockname ). Questo parametro deve essere specificato.

[out] LocalSockaddrLength

Dimensioni, in byte, dell'indirizzo locale. Questo parametro deve essere specificato.

[out] RemoteSockaddr

Puntatore alla struttura sockaddr che riceve l'indirizzo remoto della connessione (le stesse informazioni restituite dalla funzione getpeername ). Questo parametro deve essere specificato.

[out] RemoteSockaddrLength

Dimensioni, in byte, dell'indirizzo locale. Questo parametro deve essere specificato.

Valore restituito

nessuno

Osservazioni

La funzione GetAcceptExSockaddrs viene usata esclusivamente con la funzione AcceptEx per analizzare i primi dati ricevuti dal socket in indirizzi locali e remoti. La funzione AcceptEx restituisce informazioni sull'indirizzo locale e remoto in un formato interno. Gli sviluppatori di applicazioni devono usare la funzione GetAcceptExSockaddrs se è necessaria la struttura sockaddr contenente gli indirizzi locali o remoti.

Nota Il puntatore della funzione per la funzione GetAcceptExSockaddrs deve essere ottenuto in fase di esecuzione eseguendo una chiamata alla funzione WSAIoctl con il SIO_GET_EXTENSION_FUNCTION_POINTER opcode specificato. Il buffer di input passato alla funzione WSAIoctl deve contenere WSAID_GETACCEPTEXSOCKADDRS, un identificatore univoco globale (GUID) il cui valore identifica la funzione di estensione GetAcceptExSockaddrs . In caso di esito positivo, l'output restituito dalla funzione WSAIoctl contiene un puntatore alla funzione GetAcceptExSockaddrs . Il GUID WSAID_GETACCEPTEXSOCKADDRS è definito nel file di intestazione Mswsock.h .

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mswsock.h (includere Mswsock.h)
Libreria	Mswsock.lib
DLL	Mswsock.dll