GetMailslotInfo函数检索有关指定邮槽的信息。
BOOL GetMailslotInfo(
HANDLE 【hMailslot】, | //邮件槽柄 |
LPDWORD 【lpMaxMessageSize】, | //最大邮件大小的地址 |
LPDWORD 【lpNextSize】, | //下一条消息的大小的地址 |
LPDWORD 【lpMessageCount】, | //邮件数量的地址 |
LPDWORD 【lpReadTimeout】 | //读取超时地址 |
); |
参数
【hMailslot】
标识一个邮槽。CreateMailslot函数必须创建此句柄。
【lpMaxMessageSize】
指向缓冲区,指定函数返回时允许此邮槽的最大邮件大小(以字节为单位)。该值可以大于或等于创建邮槽的CreateMailslot函数的【cbMaxMsg】参数中指定的值。此参数可以为NULL。
【lpNextSize】
指向缓冲区,指定函数返回时下一个消息的大小(以字节为单位)。以下值有特殊含义:
值 | 含义 |
MAILSLOT_NO_MESSAGE | 没有下一条消息。 |
此参数可以为NULL。
【lpMessageCount】
指向缓冲区,指定等待读取的消息的总数,当函数返回时。此参数可以为NULL。
【lpReadTimeout】
指向缓冲区,指定在超时发生之前读取操作可以等待消息写入邮槽的时间量(以毫秒为单位)。函数返回时填入此参数。此参数可以为NULL。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
也可以看看