Fungsi GetAcceptExSockaddrs (mswsock.h)

Artikel
03/05/2024

Fungsi GetAcceptExSockaddrs mengurai data yang diperoleh dari panggilan ke fungsi AcceptEx dan meneruskan alamat lokal dan jarak jauh ke struktur sockaddr .

Catatan Fungsi ini adalah ekstensi khusus Microsoft untuk spesifikasi Windows Sockets.

Sintaks

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

Parameter

[in] lpOutputBuffer

Penunjuk ke buffer yang menerima blok pertama data yang dikirim pada koneksi yang dihasilkan dari panggilan AcceptEx . Harus parameter lpOutputBuffer yang sama yang diteruskan ke fungsi AcceptEx .

[in] dwReceiveDataLength

Jumlah byte dalam buffer yang digunakan untuk menerima data pertama. Nilai ini harus sama dengan parameter dwReceiveDataLength yang diteruskan ke fungsi AcceptEx .

[in] dwLocalAddressLength

Jumlah byte yang disediakan untuk informasi alamat lokal. Nilai ini harus sama dengan parameter dwLocalAddressLength yang diteruskan ke fungsi AcceptEx .

[in] dwRemoteAddressLength

Jumlah byte yang dicadangkan untuk informasi alamat jarak jauh. Nilai ini harus sama dengan parameter dwRemoteAddressLength yang diteruskan ke fungsi AcceptEx .

[out] LocalSockaddr

Penunjuk ke struktur sockaddr yang menerima alamat lokal koneksi (informasi yang sama yang akan dikembalikan oleh fungsi getsockname ). Parameter ini harus ditentukan.

[out] LocalSockaddrLength

Ukuran, dalam byte, dari alamat lokal. Parameter ini harus ditentukan.

[out] RemoteSockaddr

Penunjuk ke struktur sockaddr yang menerima alamat jarak jauh koneksi (informasi yang sama yang akan dikembalikan oleh fungsi getpeername ). Parameter ini harus ditentukan.

[out] RemoteSockaddrLength

Ukuran, dalam byte, dari alamat lokal. Parameter ini harus ditentukan.

Nilai kembali

Tidak ada

Keterangan

Fungsi GetAcceptExSockaddrs digunakan secara eksklusif dengan fungsi AcceptEx untuk mengurai data pertama yang diterima soket ke alamat lokal dan jarak jauh. Fungsi AcceptEx mengembalikan informasi alamat lokal dan jarak jauh dalam format internal. Pengembang aplikasi perlu menggunakan fungsi GetAcceptExSockaddrs jika ada kebutuhan akan struktur sockaddr yang berisi alamat lokal atau jarak jauh.

Catatan Penunjuk fungsi untuk fungsi GetAcceptExSockaddrs harus diperoleh pada durasi dengan melakukan panggilan ke fungsi WSAIoctl dengan opcode SIO_GET_EXTENSION_FUNCTION_POINTER yang ditentukan. Buffer input yang diteruskan ke fungsi WSAIoctl harus berisi WSAID_GETACCEPTEXSOCKADDRS, pengidentifikasi unik global (GUID) yang nilainya mengidentifikasi fungsi ekstensi GetAcceptExSockaddrs . Setelah berhasil, output yang dikembalikan oleh fungsi WSAIoctl berisi penunjuk ke fungsi GetAcceptExSockaddrs . GUID WSAID_GETACCEPTEXSOCKADDRS ditentukan dalam file header Mswsock.h .

Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1, Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mswsock.h (termasuk Mswsock.h)
Pustaka	Mswsock.lib
DLL	Mswsock.dll