NetMessageNameAdd function (lmmsg.h)
[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 |
|---|---|
|
Il chiamante non dispone dell'accesso appropriato per completare l'operazione. |
|
Un parametro non è corretto. |
|
Questa richiesta non è supportata. Questo errore viene restituito in Windows Vista e versioni successive. |
|
L'alias del messaggio esiste già in questo computer. Per ulteriori informazioni, vedere la sezione Osservazioni successiva. |
|
Il nome specificato è già in uso come alias di messaggio nella rete. |
|
Si è verificato un errore generale nell'hardware di rete. |
|
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 |