Platform SDK: Network Management |
The NetMessageNameGetInfo function retrieves information about a particular message alias in the message name table. The function requires that the messenger service be started.
Only members of the Administrators local group can successfully execute the NetMessageNameGetInfo function on a remote server.
NET_API_STATUS NetMessageNameGetInfo( LPCWSTR servername, LPCWSTR msgname, DWORD level, LPBYTE *bufptr );
Value | Meaning |
---|---|
0 | Return the message alias. The bufptr parameter points to a MSG_INFO_0 structure. |
1 | Return the message alias. The bufptr parameter points to a MSG_INFO_1 structure. This level exists only for compatibility. Message forwarding is not supported. |
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.
Value | Meaning |
---|---|
ERROR_ACCESS_DENIED | The user does not have access to the requested information. |
ERROR_INVALID_LEVEL | The value specified for the level parameter is invalid. |
ERROR_NOT_ENOUGH_MEMORY | Insufficient memory is available. |
NERR_NotLocalName | The message alias is not on the local computer. |
To list all the message aliases in a message name table, you can call the NetMessageNameEnum function.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Unsupported.
Header: Declared in Lmmsg.h; include Lm.h.
Library: Use Netapi32.lib.
Network Management Overview, Network Management Functions, Message Functions, MSG_INFO_0, MSG_INFO_1, NetMessageNameEnum