Funzione NetRemoveAlternateComputerName (lmjoin.h)

Articolo
08/24/2023

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