GetMailslotInfo-Funktion (winbase.h)
Ruft Informationen zum angegebenen Mailslot ab.
Syntax
BOOL GetMailslotInfo(
[in] HANDLE hMailslot,
[out, optional] LPDWORD lpMaxMessageSize,
[out, optional] LPDWORD lpNextSize,
[out, optional] LPDWORD lpMessageCount,
[out, optional] LPDWORD lpReadTimeout
);
Parameter
[in] hMailslot
Ein Handle für ein Maillot. Die CreateMailslot-Funktion muss dieses Handle erstellen.
[out, optional] lpMaxMessageSize
Die maximale Nachrichtengröße in Bytes, die für dieses Mailslot zulässig ist. Dieser Wert kann größer oder gleich dem wert sein, der im cbMaxMsg-Parameter der CreateMailslot-Funktion angegeben ist, die das mailslot erstellt hat. Dieser Parameter kann NULL sein.
[out, optional] lpNextSize
Die Größe der nächsten Nachricht in Bytes. Der folgende Wert hat eine besondere Bedeutung.
| Wert | Bedeutung |
|---|---|
|
Es gibt keine nächste Nachricht. |
Dieser Parameter kann NULL sein.
[out, optional] lpMessageCount
Die Gesamtzahl der Nachrichten, die auf das Lesen warten, wenn die Funktion zurückgibt. Dieser Parameter kann NULL sein.
[out, optional] lpReadTimeout
Die Zeitspanne eines Lesevorgangs in Millisekunden kann warten, bis eine Nachricht in das Maillot geschrieben wird, bevor ein Timeout auftritt. Dieser Parameter wird eingegeben, wenn die Funktion zurückgibt. Dieser Parameter kann NULL sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |