Condividi tramite


Funzione NetAddAlternateComputerName (lmjoin.h)

La funzione NetAddAlternateComputerName aggiunge un nome alternativo per il computer specificato.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [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] AlternateName

Puntatore a una stringa costante che specifica il nome alternativo da aggiungere. 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 AlternateName 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 NetAddAlternateComputerName è supportata in Windows XP e versioni successive.

La funzione NetAddAlternateComputerName viene usata per impostare i nomi di rete secondari per i computer. Il nome primario è il nome usato per l'autenticazione ed esegue il mapping al nome dell'account del computer.

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

Requisiti

   
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

Vedi anche

NetEnumerateComputerNames

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx