| 术语 | netmessagenamegetinfo |
| 释义 | NetMessageNameGetInfo 语法： C++ NET_API_STATUS NetMessageNameGetInfo( __in LPCWSTR servername, __in LPCWSTR msgname, __in DWORD level, __out LPBYTE *bufptr ); NetMessageNameGetInfo功能 [此功能不支持作为Windows Vista，因为信使服务不支持。] 该NetMessageNameGetInfo函数检索信息在消息名称表中特定的消息别名。该函数规定，信使服务启动。 参数 服务器名 [in] 指针常量字符串指定的DNS或NetBIOS的远程服务器上的功能是执行的名称。如果该参数为NULL，则使用本地计算机。 msgname [in] 指针常量字符串指定的消息别名要返回的信息。 Level [in] 指定的数据信息的Level。此参数可以是下列值之一。 ValueMeaning 0Return的消息别名。在bufptr参数指向MSG_INFO_0结构。 1Return的消息别名。在bufptr参数指向MSG_INFO_1结构。这个级别只存在兼容性。消息转发不支持。 bufptr [out] 指针的缓冲区，接收数据。这一数据格式取决于Level的参数值。此缓冲区分配制度，必须使用NetApiBufferFree释放功能。有关更多信息，请参阅网络管理功能，缓冲器和网络管理功能缓冲区长度。 返回值 如果函数成功，返回值是NERR_Success。 如果函数失败，返回值可以是下面的错误代码之一。 返回codeDescription ERROR_ACCESS_DENIEDThe调用方没有适当的访问，以完成操作。 ERROR_INVALID_LEVELThe价值Level参数指定无效。 ERROR_INVALID_PARAMETERA参数不正确。 ERROR_NOT_ENOUGH_MEMORYInsufficient内存可用。 ERROR_NOT_SUPPORTEDThis不支持请求。返回此错误在Windows Vista和更高版本。 是不是在本地计算机上NERR_NotLocalNameThe消息别名。 备注 系统管理员本地组的成员才可以成功地执行远程服务器上的NetMessageNameGetInfo功能。 要列出在邮件名称表中的所有邮件别名，您可以调用NetMessageNameEnum功能。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 客户supportWindows的高端XP 服务器supportWindows低端服务器2003 HeaderLmmsg.h(包括Lm.h) LibraryNetapi32.lib DLLNetapi32.dll 参见 网络管理概述 网络管理功能 消息函数 MSG_INFO_0 MSG_INFO_1 NetMessageNameEnum 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年8月13日 ＝＝英文原文＝＝NetMessageNameGetInfo Function [This function is not supported as of Windows Vista because the messenger service is not supported.] The NetMessageNameGetInfo function retrieves information about a particular message alias in the message name table. The function requires that the messenger service be started. Syntax C++ NET_API_STATUS NetMessageNameGetInfo( __in LPCWSTR servername, __in LPCWSTR msgname, __in DWORD level, __out LPBYTE *bufptr ); Parameters servername [in] Pointer to a constant string that specifies the DNS or NetBIOS name of the remote server on which the function is to execute. If this parameter is NULL, the local computer is used. msgname [in] Pointer to a constant string that specifies the message alias for which to return information. level [in] Specifies the information level of the data. This parameter can be one of the following values. ValueMeaning 0Return the message alias. The bufptr parameter points to a MSG_INFO_0 structure. 1Return the message alias. The bufptr parameter points to a MSG_INFO_1 structure. This level exists only for compatibility. Message forwarding is not supported. bufptr [out] Pointer to the buffer that receives the data. The format of this data depends on the value of the level parameter. This buffer is allocated by the system and must be freed using the NetApiBufferFree function. For more information, see Network Management Function Buffers and Network Management Function Buffer Lengths . Return Value If the function succeeds, the return value is NERR_Success. If the function fails, the return value can be one of the following error codes. Return codeDescription ERROR_ACCESS_DENIEDThe caller does not have the appropriate access to complete the operation. ERROR_INVALID_LEVELThe value specified for the level parameter is invalid. ERROR_INVALID_PARAMETERA parameter is incorrect. ERROR_NOT_ENOUGH_MEMORYInsufficient memory is available. ERROR_NOT_SUPPORTEDThis request is not supported. This error is returned on Windows Vista and later. NERR_NotLocalNameThe message alias is not on the local computer. Remarks Only members of the Administrators local group can successfully execute the NetMessageNameGetInfo function on a remote server. To list all the message aliases in a message name table, you can call the NetMessageNameEnum function. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server End of client supportWindows XP End of server supportWindows Server 2003 HeaderLmmsg.h (include Lm.h) LibraryNetapi32.lib DLLNetapi32.dll See Also Network Management Overview Network Management Functions Message Functions MSG_INFO_0 MSG_INFO_1 NetMessageNameEnum Send comments about this topic to Microsoft Build date: 8/13/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa370609(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。