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. |