NetMessageNameDel function
[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 NetMessageNameDel( _In_ LPCWSTR servername, _In_ LPCWSTR msgname );
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 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
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
End of client support |
Windows XP |
|
End of server support |
Windows Server 2003 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also