Fungsi Icmp6SendEcho2 (icmpapi.h)

Fungsi Icmp6SendEcho2 mengirimkan permintaan echo IPv6 ICMPv6 dan segera mengembalikan (jika Peristiwa atau ApcRoutine bukan NULL) atau kembali setelah waktu habis yang ditentukan. ReplyBuffer berisi respons gema IPv6 ICMPv6, jika ada.

Sintaks

IPHLPAPI_DLL_LINKAGE DWORD Icmp6SendEcho2(
  [in]           HANDLE                 IcmpHandle,
  [in, optional] HANDLE                 Event,
  [in, optional] PIO_APC_ROUTINE        ApcRoutine,
  [in, optional] PVOID                  ApcContext,
  [in]           sockaddr_in6           *SourceAddress,
  [in]           sockaddr_in6           *DestinationAddress,
  [in]           LPVOID                 RequestData,
  [in]           WORD                   RequestSize,
  [in, optional] PIP_OPTION_INFORMATION RequestOptions,
  [out]          LPVOID                 ReplyBuffer,
  [in]           DWORD                  ReplySize,
  [in]           DWORD                  Timeout
);

Parameter

[in] IcmpHandle

Handel terbuka yang dikembalikan oleh Icmp6CreateFile.

[in, optional] Event

Peristiwa yang akan disinyalkan setiap kali respons ICMPv6 tiba. Jika parameter ini ditentukan, parameter memerlukan handel ke objek peristiwa yang valid. Gunakan fungsi CreateEvent atau CreateEventEx untuk membuat objek kejadian ini.

Untuk informasi selengkapnya tentang menggunakan peristiwa, lihat Objek Peristiwa.

[in, optional] ApcRoutine

Rutinitas yang dipanggil ketika utas panggilan berada dalam utas yang dapat diperingatkan dan balasan ICMPv6 tiba. Pada Windows Vista dan yang lebih baru, PIO_APC_ROUTINE_DEFINED harus didefinisikan untuk memaksa jenis data agar parameter ini PIO_APC_ROUTINE daripada FARPROC.

Pada Windows Server 2003 dan Windows XP, PIO_APC_ROUTINE_DEFINED tidak boleh didefinisikan untuk memaksa jenis data untuk parameter ini ke FARPROC.

[in, optional] ApcContext

Parameter opsional yang diteruskan ke rutinitas panggilan balik yang ditentukan dalam parameter ApcRoutine setiap kali respons ICMPv6 tiba atau terjadi kesalahan.

[in] SourceAddress

Alamat sumber IPv6 untuk mengeluarkan permintaan echo, dalam bentuk struktur sockaddr .

[in] DestinationAddress

Alamat tujuan IPv6 dari permintaan gema, dalam bentuk struktur sockaddr .

[in] RequestData

Penunjuk ke buffer yang berisi data untuk dikirim dalam permintaan.

[in] RequestSize

Ukuran, dalam byte, dari buffer data permintaan yang diacu oleh parameter RequestData .

[in, optional] RequestOptions

Penunjuk ke opsi header IPv6 untuk permintaan, dalam bentuk struktur IP_OPTION_INFORMATION . Pada platform 64-bit, parameter ini dalam bentuk untuk struktur IP_OPTION_INFORMATION32 .

Parameter ini mungkin NULL jika tidak ada opsi header IP yang perlu ditentukan.

[out] ReplyBuffer

Penunjuk ke buffer untuk menahan balasan atas permintaan. Setelah dikembalikan, buffer berisi struktur ICMPV6_ECHO_REPLY diikuti oleh isi pesan dari data balasan respons gema ICMPv6. Buffer harus cukup besar untuk menyimpan setidaknya satu struktur ICMPV6_ECHO_REPLY ditambah jumlah byte data yang ditentukan dalam parameter RequestSize . Buffer ini juga harus cukup besar untuk juga menyimpan 8 byte data lagi (ukuran pesan kesalahan ICMP) ditambah ruang untuk struktur IO_STATUS_BLOCK .

[in] ReplySize

Ukuran, dalam byte, dari buffer balasan yang diacu oleh parameter ReplyBuffer . Buffer ini harus cukup besar untuk menyimpan setidaknya satu struktur ICMPV6_ECHO_REPLY ditambah byte data RequestSize . Buffer ini juga harus cukup besar untuk juga menyimpan 8 byte data lagi (ukuran pesan kesalahan ICMP) ditambah ruang untuk struktur IO_STATUS_BLOCK .

[in] Timeout

Waktu, dalam milidetik, untuk menunggu balasan. Parameter ini hanya digunakan jika fungsi Icmp6SendEcho2 dipanggil secara sinkron. Jadi parameter ini tidak digunakan jika parameter ApcRoutine atau Event bukan NULL.

Nilai kembali

Ketika dipanggil secara sinkron, mengembalikan jumlah balasan yang diterima dan disimpan di ReplyBuffer.

Ketika dipanggil secara asinkron, menunjukkan bahwa operasi sedang berlangsung dengan mengembalikan ERROR_IO_PENDING. Anda dapat mengambil hasil jumlah balasan nanti, ketika peristiwa yang ditentukan dalam sinyal parameter Peristiwa , atau ketika fungsi panggilan balik dalam parameter ApcRoutine dipanggil.

Jika nilai jumlah balasan (sinkron atau asinkron) adalah nol, maka untuk informasi kesalahan yang diperluas, panggil GetLastError.

Jika fungsi gagal, maka kode kesalahan yang diperluas yang dikembalikan oleh GetLastError bisa menjadi salah satu nilai berikut.

Keterangan

Fungsi Icmp6SendEcho2 dipanggil secara sinkron jika parameter ApcRoutine atau Event adalah NULL. Ketika dipanggil secara sinkron, nilai yang dikembalikan berisi jumlah balasan yang diterima dan disimpan di ReplyBuffer setelah menunggu waktu yang ditentukan dalam parameter Timeout . Jika nilai yang dikembalikan adalah nol, panggil GetLastError untuk informasi kesalahan yang diperluas.

Fungsi Icmp6SendEcho2 dipanggil secara asinkron ketika parameter ApcRoutine atau Event ditentukan. Ketika dipanggil secara asinkron, parameter ReplyBuffer dan ReplySize diperlukan untuk menerima respons. Data respons ICMP disalin ke ReplyBuffer yang disediakan dan aplikasi disinyalkan (ketika parameter Peristiwa ditentukan) atau fungsi panggilan balik dipanggil (ketika parameter ApcRoutine ditentukan). Aplikasi harus mengurai data yang diacu oleh parameter ReplyBuffer menggunakan fungsi Icmp6ParseReplies .

Jika parameter Peristiwa ditentukan, fungsi Icmp6SendEcho2 dipanggil secara asinkron. Peristiwa yang ditentukan dalam parameter Peristiwa disinyalkan setiap kali respons ICMPv6 tiba. Gunakan fungsi CreateEvent untuk membuat objek kejadian ini.

Jika parameter ApcRoutine ditentukan, fungsi Icmp6SendEcho2 dipanggil secara asinkron. Parameter ApcRoutine harus menunjuk ke fungsi panggilan balik yang ditentukan pengguna. Fungsi panggilan balik yang ditentukan dalam parameter ApcRoutine dipanggil setiap kali respons ICMPv6 tiba. Pemanggilan fungsi panggilan balik yang ditentukan dalam parameter ApcRoutine diserialisasikan.

Jika parameter Peristiwa dan ApcRoutine ditentukan, peristiwa yang ditentukan dalam parameter Peristiwa disinyalkan setiap kali respons ICMPv6 tiba, tetapi fungsi panggilan balik yang ditentukan dalam parameter ApcRoutine diabaikan .

Pada Windows Vista dan yang lebih baru, aplikasi apa pun yang memanggil fungsi Icmp6SendEcho2 secara asinkron menggunakan parameter ApcRoutine harus menentukan PIO_APC_ROUTINE_DEFINED untuk memaksa jenis data parameter ApcRoutine ke PIO_APC_ROUTINE daripada FARPROC.

Pada Windows Vista dan yang lebih baru, fungsi panggilan balik yang ditunjukkan oleh ApcRoutine harus didefinisikan sebagai fungsi jenis VOID dengan sintaks berikut:

typedef
VOID WINAPI
(*PIO_APC_ROUTINE) (
    IN PVOID ApcContext,
    IN PIO_STATUS_BLOCK IoStatusBlock,
    IN ULONG Reserved
    );

Pada Windows Vista dan yang lebih baru, parameter yang diteruskan ke fungsi panggilan balik meliputi yang berikut ini:

Pada Windows Server 2003 dan Windows XP, aplikasi apa pun yang memanggil fungsi Icmp6SendEcho2 secara asinkron menggunakan parameter ApcRoutine tidak boleh menentukan PIO_APC_ROUTINE_DEFINED untuk memaksa jenis data untuk parameter ApcRoutine ke FARPROC daripada PIO_APC_ROUTINE.

Pada Windows Server 2003 dan Windows XP, fungsi panggilan balik yang ditunjukkan oleh ApcRoutine harus didefinisikan sebagai fungsi jenis VOID dengan sintaks berikut:

typedef
VOID WINAPI
(*FARPROC) (
    IN PVOID ApcContext,
    );

Pada Windows Server 2003 dan Windows XP, parameter yang diteruskan ke fungsi panggilan balik meliputi yang berikut ini:

Fungsi panggilan balik yang ditentukan dalam parameter ApcRoutine harus diimplementasikan dalam proses yang sama dengan aplikasi yang memanggil fungsi Icmp6SendEcho2 . Jika fungsi panggilan balik berada dalam DLL terpisah, maka DLL harus dimuat sebelum memanggil fungsi Icmp6SendEcho2 .

Untuk IPv4, gunakan fungsi IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex, dan IcmpParseReplies .

Perhatikan bahwa direktif sertakan untuk file header Iphlpapi.h harus ditempatkan sebelum file header Icmpapi.h .

Persyaratan

Lihat juga

CreateEvent

CreateEventEx

Objek Peristiwa

GetLastError

ICMPV6_ECHO_REPLY

ICMP_ECHO_REPLY

IP_OPTION_INFORMATION

Icmp6CreateFile

Icmp6ParseReplies

IcmpCloseHandle

IcmpCreateFile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex

sockaddr