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 |
|---|---|
|
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 AlternateName 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 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 |