NetMessageBufferSend function (lmmsg.h)
[This function is not supported as of Windows Vista because the messenger service is not supported.]
The NetMessageBufferSend function sends a buffer of information to a registered message alias.
Syntax
NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
[in] LPCWSTR servername,
[in] LPCWSTR msgname,
[in] LPCWSTR fromname,
[in] LPBYTE buf,
[in] DWORD buflen
);
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 which the message buffer should be sent.
[in] fromname
Pointer to a constant string specifying who the message is from. If this parameter is NULL, the message is sent from the local computer name.
[in] buf
Pointer to a buffer that contains the message text. For more information, see Network Management Function Buffers.
[in] buflen
Specifies a value that contains the length, in bytes, of the message text pointed to by the buf parameter.
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. |
|
The user name could not be found. |
|
A general failure occurred in the network hardware. |
Remarks
If you call this function on a domain controller that is running Active Directory, access is allowed or denied based on the access control list (ACL) for the securable object. The default ACL permits only Domain Admins and Account Operators to call this function. On a member server or workstation, only Administrators and Server Operators can call this function. For more information, see Security Requirements for the Network Management Functions. For more information on ACLs and ACEs, see Access Control Model.
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 |