GetMailslotInfo, fonction (winbase.h)

Récupère des informations sur le maillot spécifié.

Syntaxe

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

Paramètres

[in] hMailslot

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

[out, optional] lpMaxMessageSize

Taille maximale du message, en octets, autorisée pour ce maillot. Cette valeur peut être supérieure ou égale à la valeur spécifiée dans le paramètre cbMaxMsg de la fonction CreateMailslot qui a créé le maillot. Ce paramètre peut être NULL.

[out, optional] lpNextSize

Taille du message suivant, en octets. La valeur suivante a une signification spéciale.

Valeur	Signification
MAILSLOT_NO_MESSAGE ((DWORD)-1)	Il n’y a pas de message suivant.

 

Ce paramètre peut être NULL.

[out, optional] lpMessageCount

Nombre total de messages en attente de lecture, lorsque la fonction retourne. Ce paramètre peut être NULL.

[out, optional] lpReadTimeout

Durée, en millisecondes, d’une opération de lecture peut attendre qu’un message soit écrit dans le maillot avant qu’un délai d’attente ne se produise. Ce paramètre est renseigné lorsque la fonction retourne. Ce paramètre peut être NULL.

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.

Configuration requise

Condition requise	Valeur
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

Fonctions de maillot

Vue d’ensemble des maillots

SetMailslotInfo