3.1.4.4 NetrMessageNameDel (Opnum 3)

The NetrMessageNameDel (Opnum 3) interface is used to configure the message server to stop listening for messages for a particular NetBIOS name.

 NET_API_STATUS NET_API_FUNCTION NetrMessageNameDel(
   [in, string, unique] MSGSVC_HANDLE ServerName,
   [in, string] wchar_t* MsgName
 );

ServerName: A pointer to a null-terminated string that MUST denote the NetBIOS name (as specified in [RFC1001] section 5.2) or the fully qualified domain name (FQDN) of the remote computer on which the function is to execute. There are no other constraints on the format of this string. The message server MUST ignore this parameter.

MsgName:  A null-terminated Unicode UTF-16 string that MUST denote the recipient name to delete. It is limited in length to 16 characters.<10>

Return Values: A NET_API_STATUS value that indicates return status. If the method returns a negative value, the method has failed. If the 12-bit facility code (bits 16–27) is set to 0x007, the value contains a Win32 error code (defined in [MS-ERREF]) in the lower 16 bits. Zero or positive values indicate success, with the lower 16 bits in positive nonzero values containing warnings or flags defined in the method implementation.

Return value/code

Description

0x00000000

NERR_Success

The operation completed successfully.

0x00000005

ERROR_ACCESS_DENIED

Access is denied.

0x0000007B

ERROR_INVALID_NAME

The file name, directory name, or volume label syntax is incorrect.

0x000008E6

NERR_DelComputerName

The computer name could not be deleted.

0x000008EB

NERR_NameInUse

The message alias is currently in use. Try again later.

0x000008ED

NERR_NotLocalName

The name is not on the local computer.

0x000008FB

NERR_IncompleteDel

The message alias was not successfully deleted from all networks.