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 |
|---|---|
|
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 |