Funzione GetMailslotInfo (winbase.h)
Recupera informazioni sul mailslot specificato.
Sintassi
BOOL GetMailslotInfo(
[in] HANDLE hMailslot,
[out, optional] LPDWORD lpMaxMessageSize,
[out, optional] LPDWORD lpNextSize,
[out, optional] LPDWORD lpMessageCount,
[out, optional] LPDWORD lpReadTimeout
);
Parametri
[in] hMailslot
Handle per un mailslot. La funzione CreateMailslot deve creare questo handle.
[out, optional] lpMaxMessageSize
Dimensione massima del messaggio, in byte, consentita per questo mailslot. Questo valore può essere maggiore o uguale al valore specificato nel parametro cbMaxMsg della funzione CreateMailslot che ha creato mailslot. Questo parametro può essere NULL.
[out, optional] lpNextSize
Dimensioni del messaggio successivo, in byte. Il valore seguente ha un significato speciale.
| Valore | Significato |
|---|---|
|
Non è presente alcun messaggio successivo. |
Questo parametro può essere NULL.
[out, optional] lpMessageCount
Numero totale di messaggi in attesa di lettura, quando la funzione restituisce. Questo parametro può essere NULL.
[out, optional] lpReadTimeout
La quantità di tempo, in millisecondi, un'operazione di lettura può attendere che un messaggio venga scritto nel mailslot prima che si verifichi un timeout.The amount of timeout, in milliseconds, a read operation can wait for a message to be written to the mailslot before a timeout. Questo parametro viene compilato quando viene restituita la funzione. Questo parametro può essere NULL.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |