Funzione NetEnumerateComputerNames (lmjoin.h)

Articolo
08/24/2023

La funzione NetEnumerateComputerNames enumera i nomi per il computer specificato.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetEnumerateComputerNames(
  [in, optional] LPCWSTR                Server,
  [in]           NET_COMPUTER_NAME_TYPE NameType,
  [in]           ULONG                  Reserved,
  [out]          PDWORD                 EntryCount,
  [out]          LPWSTR                 **ComputerNames
);

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

Tipo del nome sottoposto a query. Questo membro può essere uno dei valori seguenti definiti nell'enumerazione NET_COMPUTER_NAME_TYPE definita nel file di intestazione Lmjoin.h .

Valore	Significato
NetPrimaryComputerName	Nome computer primario.
NetAlternateComputerNames	Nomi di computer alternativi.
NetAllComputerNames	Tutti i nomi di computer.
NetComputerNameTypeMax	Indica la fine dell'intervallo che specifica i valori possibili per il tipo di nome su cui eseguire la query.

[in] Reserved

Riservato per utilizzi futuri. Questo parametro deve essere NULL.

[out] EntryCount

Puntatore a un valore DWORD che restituisce il numero di nomi restituiti nel buffer a cui punta il parametro ComputerNames se la funzione ha esito positivo.

[out] ComputerNames

Puntatore a una matrice di puntatori ai nomi. Se la chiamata di funzione ha esito positivo, questo parametro restituirà i nomi del computer corrispondenti al nome del tipo di computer specificato nel parametro NameType .

Quando l'applicazione non richiede più questa matrice, questo buffer deve essere liberato chiamando la funzione NetApiBufferFree .

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_PARAMETER	Un parametro non è corretto.
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 NetEnumerateComputerNames è supportata in Windows Vista e versioni successive.

La funzione NetEnumerateComputerNames viene utilizzata per richiedere i nomi attualmente configurati da un computer.

La funzione NetEnumerateComputerNames 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