Platform SDK: Network Management

NetMessageNameDel

The NetMessageNameDel function deletes a message alias in the message name table. The function requires that the messenger service be started.

Security Requirements

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

NET_API_STATUS NetMessageNameDel(
  LPCWSTR servername,  
  LPCWSTR msgname      
);

Parameters

servername: [in] Pointer to a constant Unicode string specifying the name of the remote server on which the function is to execute. The string must begin with \\. If this parameter is NULL, the local computer is used.
msgname: [in] Pointer to a constant Unicode string specifying the message alias to delete. The string cannot be more than 15 characters long.

Return Values

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.
NERR_DelComputerName	A message alias that is also a computer name cannot be deleted.
NERR_IncompleteDel	The message alias was not successfully deleted from all networks.
NERR_NameInUse	The message alias is currently in use. Try again later.
NERR_NotLocalName	The message alias is not on the local computer.

Requirements

  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.

NetMessageNameDel

Security Requirements

Parameters

Return Values

Requirements

See Also