NetServerComputerNameAdd function (lmserver.h)

Articolo
03/13/2024

La funzione NetServerComputerNameAdd enumera i trasporti in cui il server specificato è attivo e associa il nome del server emulato a ognuno dei trasporti.

NetServerComputerNameAdd è una funzione di utilità che combina la funzionalità della funzione NetServerTransportEnum e la funzione NetServerTransportAddEx .

Sintassi

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Parametri

[in] ServerName

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

[in] EmulatedDomainName

Puntatore a una stringa contenente il nome di dominio che il server specificato deve usare quando annuncia la sua presenza usando EmulatedServerName. Questo parametro è facoltativo e,

[in] EmulatedServerName

Puntatore a una stringa di caratteri con terminazione null contenente il nome emulato del server deve iniziare a supportare oltre al nome specificato dal parametro ServerName .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success. Si noti che NetServerComputerNameAdd ha esito positivo se il nome del server emulato specificato viene aggiunto a almeno un trasporto.

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

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	L'utente non ha accesso alle informazioni richieste.
ERROR_DUP_NAME	Esiste un nome duplicato nella rete.
ERROR_INVALID_DOMAINNAME	Impossibile trovare il nome di dominio nella rete.
ERROR_INVALID_PARAMETER	Il parametro specificato non è valido.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente disponibile.

Commenti

Solo i membri del gruppo locale Administrators o Server Operator possono eseguire correttamente la funzione NetServerComputerNameAdd .

Il server specificato dal parametro ServerName continua a supportare tutti i nomi supportati e inizia inoltre a supportare nuovi nomi forniti da chiamate riuscite alla funzione NetServerComputerNameAdd .

L'emulazione dei nomi risultante da una chiamata a NetServerComputerNameAdd viene interrotta quando il server viene riavviato o riavviato. Per interrompere l'emulazione dei nomi impostata da una chiamata precedente a NetServerComputerNameAdd senza riavviare o riavviare, è possibile chiamare la funzione NetServerComputerNameDel .

La funzione NetServerComputerNameAdd viene in genere usata quando un amministratore di sistema sostituisce un server, ma vuole mantenere la conversione trasparente agli utenti.

Esempio

Di seguito è riportato un esempio di chiamata alla funzione NetServerComputerNameAdd che \Server1 risponde anche alle richieste per \Server2.

NetServerComputerNameAdd (Server1, NULL, Server2);

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	lmserver.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll