NetMessageNameDel function (lmmsg.h)
[This function is not supported as of Windows Vista because the messenger service is not supported.]
The NetMessageNameDel function deletes a message alias in the message name table. The function requires that the messenger service be started.
Syntax
NET_API_STATUS NET_API_FUNCTION NetMessageNameDel(
[in] LPCWSTR servername,
[in] LPCWSTR msgname
);
Parameters
[in] servername
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.
[in] msgname
Pointer to a constant string that specifies the message alias to delete. The string cannot be more than 15 characters long.
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 code | Description |
---|---|
|
The caller does not have the appropriate access to complete the operation. |
|
A parameter is incorrect. |
|
This request is not supported. This error is returned on Windows Vista and later. |
|
A message alias that is also a computer name cannot be deleted. |
|
The message alias was not successfully deleted from all networks. |
|
The message alias is currently in use. Try again later. |
|
The message alias is not on the local computer. |
Remarks
Only members of the Administrators local group can successfully execute the NetMessageNameDel function on a remote server.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | lmmsg.h (include Lm.h) |
Library | Netapi32.lib |
DLL | Netapi32.dll |