3.2.4.1 NetrSendMessage (Opnum 0)

The NetrSendMessage (Opnum 0) method is used to send a text message to a message server.

 error_status_t NetrSendMessage(
   [in] handle_t hRpcBinding,
   [in, string] LPSTR From,
   [in, string] LPSTR To,
   [in, string] LPSTR Text
 );

hRpcBinding:  An RPC primitive binding handle, which MUST be as specified in [C706] section 4 and [C706] section 5.<21>

From: A null-terminated string that MUST denote the name of the sender of the message. The name is not guaranteed to be unique or reachable by this method. The string MUST be expressed in the original equipment manufacturer (OEM) character set, as specified in [MS-UCODEREF] section 2.2.1, of the invoker of this method.

To: A null-terminated string that MUST represent the name of the intended recipient of the message. The name is not guaranteed to be unique or reachable by this method. The string is expressed in the OEM character set, as specified in [MS-UCODEREF] section 2.2.1, of the invoker of this method.

Text: A null-terminated string that MUST contain the message that is being sent to the recipient in the To parameter. The string is expressed in the OEM character set, as specified in [MS-UCODEREF] section 2.2.1.

Return Values: An error_status_t 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 ERROR_SUCCESS	The operation completed successfully.
0x00000005 ERROR_ACCESS_DENIED	Access is denied.
0x00000032 ERROR_NOT_SUPPORTED	The request is not supported.<22>
0x00000057 ERROR_INVALID_PARAMETER	The parameter is incorrect.
0x00000858 NERR_NetworkError	A general network error occurred.
0x000008E1 NERR_NameNotFound	The message alias could not be found on the network.
0x000008E8 NERR_GrpMsgProcessor	An error occurred in the domain message processor.
0x000008E9 NERR_PausedRemote	The message was sent, but the recipient has paused the Messenger service.
0x000008EA NERR_BadReceive	The message was sent but not received.
0x000008EB NERR_NameInUse	The message alias is currently in use. Try again later.
0x000008ED NERR_NotLocalName	The name is not on the local computer.
0x000008F1 NERR_TruncatedBroadcast	The broadcast message was truncated.
0x000008F9 NERR_DuplicateName	A duplicate message alias exists on the network.