Partager via


NetEnumerateComputerNames, fonction (lmjoin.h)

La fonction NetEnumerateComputerNames énumère les noms de l’ordinateur spécifié.

Syntaxe

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

Paramètres

[in, optional] Server

Pointeur vers une chaîne constante qui spécifie le nom de l’ordinateur sur lequel exécuter cette fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] NameType

Type du nom interrogé. Ce membre peut être l’une des valeurs suivantes définies dans l’énumération NET_COMPUTER_NAME_TYPE définie dans le fichier d’en-tête Lmjoin.h .

Valeur Signification
NetPrimaryComputerName
Nom de l’ordinateur principal.
NetAlternateComputerNames
Autres noms d’ordinateurs.
NetAllComputerNames
Tous les noms d’ordinateurs.
NetComputerNameTypeMax
Indique la fin de la plage qui spécifie les valeurs possibles pour le type de nom à interroger.

[in] Reserved

Réservé pour un usage futur. Ce paramètre doit être NULL.

[out] EntryCount

Pointeur vers une valeur DWORD qui retourne le nombre de noms retournés dans la mémoire tampon pointée par le paramètre ComputerNames si la fonction réussit.

[out] ComputerNames

Pointeur vers un tableau de pointeurs vers des noms. Si l’appel de fonction réussit, ce paramètre retourne les noms d’ordinateurs qui correspondent au nom de type d’ordinateur spécifié dans le paramètre NameType .

Lorsque l’application n’a plus besoin de ce tableau, cette mémoire tampon doit être libérée en appelant la fonction NetApiBufferFree .

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants ou l’un des codes d’erreur système.

Code de retour Description
ERROR_ACCESS_DENIED
Accès refusé. Cette erreur est retournée si l’appelant n’était pas membre du groupe local Administrateurs sur l’ordinateur cible.
ERROR_INVALID_PARAMETER
Un paramètre est incorrect.
ERROR_NOT_ENOUGH_MEMORY
La mémoire disponible est insuffisante pour traiter cette commande.
ERROR_NOT_SUPPORTED
La demande n'est pas prise en charge. Cette erreur est retournée si l’ordinateur cible spécifié dans le paramètre Server sur lequel cette fonction s’exécute s’exécute sur Windows 2000 et versions antérieures.
NERR_WkstaNotStarted
Le service Station de travail n’a pas été démarré.
RPC_S_CALL_IN_PROGRESS
Un appel de procédure distante est déjà en cours pour ce thread.
RPC_S_PROTSEQ_NOT_SUPPORTED
La séquence de protocole d’appel de procédure distante n’est pas prise en charge.

Notes

La fonction NetEnumerateComputerNames est prise en charge sur Windows Vista et versions ultérieures.

La fonction NetEnumerateComputerNames est utilisée pour demander les noms qu’un ordinateur a actuellement configurés.

La fonction NetEnumerateComputerNames nécessite que l’appelant soit membre du groupe local Administrateurs sur l’ordinateur cible.

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête lmjoin.h (include Lm.h)
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

NetAddAlternateComputerName

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx