Funzione NetMessageBufferSend (lmmsg.h)

Articolo
08/24/2023

[Questa funzione non è supportata come in Windows Vista perché il servizio messenger non è supportato.]

La funzione NetMessageBufferSend invia un buffer di informazioni a un alias di messaggio registrato.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

Parametri

[in] servername

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

[in] msgname

Puntatore a una stringa costante che specifica l'alias del messaggio a cui deve essere inviato il buffer del messaggio.

[in] fromname

Puntatore a una stringa costante che specifica l'origine del messaggio. Se questo parametro è NULL, il messaggio viene inviato dal nome del computer locale.

[in] buf

Puntatore a un buffer contenente il testo del messaggio. Per altre informazioni, vedere Buffer delle funzioni di gestione della rete.

[in] buflen

Specifica un valore che contiene la lunghezza, in byte, del testo del messaggio a cui punta il parametro buf .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato per completare l'operazione.
ERROR_INVALID_PARAMETER	Un parametro non è corretto.
ERROR_NOT_SUPPORTED	Questa richiesta non è supportata. Questo errore viene restituito in Windows Vista e versioni successive.
NERR_NameNotFound	Impossibile trovare il nome utente.
NERR_NetworkError	Si è verificato un errore generale nell'hardware di rete.

Commenti

Se si chiama questa funzione in un controller di dominio che esegue Active Directory, l'accesso è consentito o negato in base all'elenco di controllo di accesso (ACL) per l'oggetto a protezione diretta. L'elenco di controllo di accesso predefinito consente solo agli amministratori di dominio e agli operatori account di chiamare questa funzione. In un server membro o in una workstation, solo gli amministratori e gli operatori server possono chiamare questa funzione. Per altre informazioni, vedere Requisiti di sicurezza per le funzioni di gestione della rete. Per altre informazioni sugli ACL e sugli ACL, vedere Controllo di accesso Modello.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmmsg.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll