Fungsi GetMailslotInfo (winbase.h)

Mengambil informasi tentang mailslot yang ditentukan.

Sintaks

BOOL GetMailslotInfo(
  [in]            HANDLE  hMailslot,
  [out, optional] LPDWORD lpMaxMessageSize,
  [out, optional] LPDWORD lpNextSize,
  [out, optional] LPDWORD lpMessageCount,
  [out, optional] LPDWORD lpReadTimeout
);

Parameter

[in] hMailslot

Handel ke mailslot. Fungsi CreateMailslot harus membuat handel ini.

[out, optional] lpMaxMessageSize

Ukuran pesan maksimum, dalam byte, diperbolehkan untuk mailslot ini. Nilai ini bisa lebih besar dari atau sama dengan nilai yang ditentukan dalam parameter cbMaxMsg dari fungsi CreateMailslot yang membuat mailslot. Parameter ini bisa NULL.

[out, optional] lpNextSize

Ukuran pesan berikutnya, dalam byte. Nilai berikut memiliki arti khusus.

Nilai	Makna
MAILSLOT_NO_MESSAGE ((DWORD)-1)	Tidak ada pesan berikutnya.

 

Parameter ini bisa NULL.

[out, optional] lpMessageCount

Jumlah total pesan yang menunggu untuk dibaca, ketika fungsi kembali. Parameter ini bisa NULL.

[out, optional] lpReadTimeout

Jumlah waktu, dalam milidetik, operasi baca dapat menunggu pesan ditulis ke mailslot sebelum waktu habis terjadi. Parameter ini diisi ketika fungsi kembali. Parameter ini bisa NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CreateMailslot

Fungsi Mailslot

Gambaran Umum Mailslots

SetMailslotInfo