Funzione NetRemoveAlternateComputerName (lmjoin.h)
La funzione NetRemoveAlternateComputerName rimuove un nome alternativo per il computer specificato.
Sintassi
NET_API_STATUS NET_API_FUNCTION NetRemoveAlternateComputerName(
[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 rimuovere. 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 NetRemoveAlternateComputerName è supportata in Windows XP e versioni successive.
La funzione NetRemoveAlternateComputerName viene utilizzata per rimuovere i nomi di computer secondari configurati per il computer di destinazione.
La funzione NetRemoveAlternateComputerName 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 |