Prev Next

NetMessageNameAdd info Overview Group

The NetMessageNameAdd function registers a message alias in the message name table. This function requires that the Messenger service be started.

Security Requirements

Only members of the Administrators local group can successfully execute NetMessageNameAdd on a remote server.

NET_API_STATUS NetMessageNameAdd(

LPTSTR servername,
LPTSTR msgname
);

Parameters

servername: Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.
msgname: Pointer to a Unicode string containing the message name to be added. The string cannot be more than 15 characters long.

Return Values

If the function returns account information, the return value is NERR_Success.

If the function fails, the return value is one of the following error codes.

Value	Meaning

ERROR_INVALID_PARAMETER	The specified parameter is invalid.
NERR_AlreadyExists	The message alias already exists on this computer.
NERR_DuplicateName	The name specified is already in use as a message alias on the network.
NERR_NetworkError	A general failure occurred in the network hardware.
NERR_TooManyNames	The maximum number of message aliases has been exceeded.

Remarks

The forward action flag from the LAN Manager 2.x NetMessageNameAdd function is no longer a parameter because message forwarding is no longer supported. If the NetMessageNameAdd function detects that a forwarded version of msgname exists on the network, the function will fail with error NERR_Already_Exists.