Funzione SetMailslotInfo (winbase.h)

Articolo
03/08/2023

Imposta il valore di timeout utilizzato dalla mailslot specificata per un'operazione di lettura.

Sintassi

BOOL SetMailslotInfo(
  [in] HANDLE hMailslot,
  [in] DWORD  lReadTimeout
);

Parametri

[in] hMailslot

Handle a una mailslot. La funzione CreateMailslot deve creare questo handle.

[in] lReadTimeout

Il tempo in cui un'operazione di lettura può attendere che un messaggio venga scritto nella mailslot prima che si verifichi un timeout, in millisecondi. I valori seguenti hanno significati speciali.

Valore	Significato
0	Restituisce immediatamente se non è presente alcun messaggio. Il sistema non considera una restituzione immediata come errore.
MAILSLOT_WAIT_FOREVER ((DWORD)-1)	Attende per sempre un messaggio.

Questo valore di timeout si applica a tutte le operazioni di lettura successive e a tutti gli handle di posta ereditati.

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.

Commenti

Il valore di timeout iniziale utilizzato da un mailslot per un'operazione di lettura viene in genere impostato da CreateMailslot quando viene creata la mailslot.

Requisiti


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

Vedere anche

CreateMailslot

GetMailslotInfo

Funzioni Mailslot

Panoramica di Mailslots

Condividi tramite