NetMessageNameAdd function (lmmsg.h)

Articolo
03/05/2024

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

La funzione NetMessageNameAdd registra un alias di messaggio nella tabella dei nomi del messaggio. La funzione richiede l'avvio del servizio messenger.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

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 da aggiungere. La stringa non può essere di più di 15 caratteri.

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_AlreadyExists	L'alias del messaggio esiste già in questo computer. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
NERR_DuplicateName	Il nome specificato è già in uso come alias di messaggio nella rete.
NERR_NetworkError	Si è verificato un errore generale nell'hardware di rete.
NERR_TooManyNames	Il numero massimo di alias di messaggio è stato superato.

Commenti

Solo i membri del gruppo locale Administrators possono eseguire correttamente la funzione NetMessageNameAdd in un server remoto.

Il flag di azione in avanti non è più un parametro per LAN Manager 2. xNetMessageNameAdd funzione perché l'inoltro dei messaggi non è più supportato. Se la funzione NetMessageNameAdd rileva che esiste una versione inoltrata di msgname nella rete, la funzione avrà esito negativo con errore NERR_Already_Exists.

Requisiti

Requisito	Valore
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

Vedi anche

Funzioni di messaggio

NetMessageNameDel

Funzioni di gestione della rete

Panoramica sulla gestione della rete

Condividi tramite