Fonction SetMailslotInfo (winbase.h)

Article
08/27/2023

Définit la valeur de délai d’attente utilisée par le maillot spécifié pour une opération de lecture.

Syntaxe

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

Paramètres

[in] hMailslot

Handle à un maillot. La fonction CreateMailslot doit créer ce handle.

[in] lReadTimeout

Heure à laquelle une opération de lecture peut attendre qu’un message soit écrit dans le maillot avant qu’un délai d’expiration ne se produise, en millisecondes. Les valeurs suivantes ont des significations spéciales.

Valeur	Signification
0	Retourne immédiatement si aucun message n’est présent. (Le système ne traite pas un retour immédiat comme une erreur.)
MAILSLOT_WAIT_FOREVER ((DWORD)-1)	Attend toujours un message.

Cette valeur de délai d’attente s’applique à toutes les opérations de lecture suivantes et à tous les handles de maillot hérités.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La valeur de délai d’attente initiale utilisée par un maillot pour une opération de lecture est généralement définie par CreateMailslot lors de la création du maillot.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateMailslot

GetMailslotInfo

Fonctions de maillot

Vue d’ensemble des maillots

Partager via