Funzione NetSetPrimaryComputerName (lmjoin.h)
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 |
|---|---|
|
Accesso negato. Questo errore viene restituito se il chiamante non è membro del gruppo locale Administrators nel computer di destinazione. |
|
Un parametro name non è corretto. Questo errore viene restituito se il parametro PrimaryName non contiene un nome valido. |
|
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. |
|
Memoria insufficiente per l'elaborazione di questo comando. |
|
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. |
|
Il servizio Workstation non è stato avviato. |
|
Una chiamata di procedura remota è già in corso per questo thread. |
|
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 |