术语 | getmailslotinfo |
释义 | GetMailslotInfo 语法: C++ BOOL WINAPI GetMailslotInfo( __in HANDLE hMailslot, __out_opt LPDWORD lpMaxMessageSize, __out_opt LPDWORD lpNextSize, __out_opt LPDWORD lpMessageCount, __out_opt LPDWORD lpReadTimeout ); GetMailslotInfo功能 检索信息指定邮筒。 参数 hMailslot [in] 一个句柄,邮筒。该CreateMailslot函数必须创建此处理。 lpMaxMessageSize [指出,可选] 最大邮件大小,以字节,允许这邮筒。该值可以是大于或等于在CreateMailslot功能,创造了邮筒cbMaxMsg参数指定的值。此参数可以为NULL。 lpNextSize [指出,可选] 下一个邮件的大小,以字节为单位。下面的价值具有特殊的意义。 ValueMeaning MAILSLOT_NO_MESSAGE ((DWORD值)-1)没有下一条消息。 此参数可以为NULL。 lpMessageCount [指出,可选] 在等待邮件总数要读取,当函数返回。此参数可以为NULL。 lpReadTimeout [指出,可选] 的时间量,以毫秒为单位,一读操作可以等待消息写入时间之前向邮筒发生超时。此参数填充函数返回时。此参数可以为NULL。 返回值 如果函数成功,返回值为非零。 如果函数失败,返回值是零。为了获得更多错误信息,调用GetLastError。 实例 有关示例,请参见读取邮件槽。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderWinbase.h(头文件:winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 CreateMailslot 邮槽函数 邮筒概述 SetMailslotInfo 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年7月30日 ==英文原文==GetMailslotInfo Function Retrieves information about the specified mailslot. Syntax C++ BOOL WINAPI GetMailslotInfo( __in HANDLE hMailslot, __out_opt LPDWORD lpMaxMessageSize, __out_opt LPDWORD lpNextSize, __out_opt LPDWORD lpMessageCount, __out_opt LPDWORD lpReadTimeout ); Parameters hMailslot [in] A handle to a mailslot. The CreateMailslot function must create this handle. lpMaxMessageSize [out, optional] The maximum message size, in bytes, allowed for this mailslot. This value can be greater than or equal to the value specified in the cbMaxMsg parameter of the CreateMailslot function that created the mailslot. This parameter can be NULL. lpNextSize [out, optional] The size of the next message, in bytes. The following value has special meaning. ValueMeaning MAILSLOT_NO_MESSAGE ((DWORD)-1)There is no next message. This parameter can be NULL. lpMessageCount [out, optional] The total number of messages waiting to be read, when the function returns. This parameter can be NULL. lpReadTimeout [out, optional] The amount of time, in milliseconds, a read operation can wait for a message to be written to the mailslot before a time-out occurs. This parameter is filled in when the function returns. This parameter can be NULL. Return Value If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError . Examples For an example, see Reading from a Mailslot . Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also CreateMailslot Mailslot Functions Mailslots Overview SetMailslotInfo Send comments about this topic to Microsoft Build date: 7/30/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa365435(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。