Funzione NetSetPrimaryComputerName (lmjoin.h)

Articolo
02/28/2024

La funzione NetSetPrimaryComputerName imposta il nome del computer primario per il computer specificato.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

Parametri

[in, optional] Server

Puntatore a una stringa costante che specifica il nome del computer in cui eseguire questa funzione. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] PrimaryName

Puntatore a una stringa costante che specifica il nome primario da impostare. Questo nome deve essere sotto forma di nome DNS completo.

[in, optional] DomainAccount

Puntatore a una stringa costante che specifica l'account di dominio da utilizzare per accedere all'oggetto account computer per il computer specificato nel parametro Server in Active Directory. Se questo parametro è NULL, vengono utilizzate le credenziali dell'utente che esegue questa routine.

Questo parametro non viene usato se il server per eseguire questa funzione non è aggiunto a un dominio.

[in, optional] DomainAccountPassword

Puntatore a una stringa costante che specifica la password corrispondente all'account di dominio passato nel parametro DomainAccount . Se questo parametro è NULL, vengono utilizzate le credenziali dell'utente che esegue questa routine.

Questo parametro viene ignorato se il parametro DomainAccount è NULL. Questo parametro non viene usato se il server per eseguire questa funzione non è aggiunto a un dominio.

[in] Reserved

Riservato per utilizzi futuri. Questo parametro deve essere NULL.

Valore restituito

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

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

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Accesso negato. Questo errore viene restituito se il chiamante non è membro del gruppo locale Administrators nel computer di destinazione.
ERROR_INVALID_NAME	Un parametro name non è corretto. Questo errore viene restituito se il parametro PrimaryName non contiene un nome valido.
ERROR_INVALID_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se il parametro DomainAccount non contiene un dominio valido. Questo errore viene restituito anche se il parametro DomainAccount non è NULL e il parametro DomainAccountPassword non è NULL ma non contiene una stringa Unicode.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per l'elaborazione di questo comando.
ERROR_NOT_SUPPORTED	La richiesta non è supportata. Questo errore viene restituito se il computer di destinazione specificato nel parametro Server in cui viene eseguita questa funzione è in esecuzione in Windows 2000 e versioni precedenti.
NERR_WkstaNotStarted	Il servizio Workstation non è stato avviato.
RPC_S_CALL_IN_PROGRESS	Una chiamata di procedura remota è già in corso per questo thread.
RPC_S_PROTSEQ_NOT_SUPPORTED	La sequenza di protocollo di chiamata di procedura remota non è supportata.

Commenti

La funzione NetSetPrimaryComputerName è supportata in Windows XP e versioni successive.

La funzione NetSetPrimaryComputerName viene utilizzata come parte delle operazioni di ridenominazione del computer. Il nome specificato verrà rimosso dall'elenco dei nomi alternativi configurato per il computer di destinazione e configurato come nome primario. Il nome dell'account computer verrà modificato in modo che corrisponda al nome primario. Il nome del computer primario precedente viene spostato nell'elenco di nomi computer alternativi configurato per il computer.

La funzione NetSetPrimaryComputerName richiede che il chiamante sia membro del gruppo locale Administrators nel computer di destinazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmjoin.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll