CM_Enumerate_Enumerators_ExA, fonction (cfgmgr32.h)

Article
08/22/2023

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Enumerate_Enumerators à la place.]

La fonction CM_Enumerate_Enumerators_Ex énumère les énumérateurs d’appareils d’un ordinateur local ou distant, en fournissant le nom de chaque énumérateur.

Syntaxe

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExA(
  [in]           ULONG    ulEnumIndex,
  [out]          PSTR     Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Paramètres

[in] ulEnumIndex

Index fourni par l’appelant dans la liste des énumérateurs d’appareils de la machine. Pour plus d’informations, consultez la section Notes suivante.

[out] Buffer

Adresse d’une mémoire tampon pour recevoir un nom d’énumérateur. Cette mémoire tampon doit être MAX_DEVICE_ID_LEN dimensionnée (ou, définissez Buffer sur zéro et obtenez la longueur de nom réelle à l’emplacement référencé par puLength).

[in, out] pulLength

Adresse fournie par l’appelant d’un emplacement pour contenir la taille de la mémoire tampon. L’appelant fournit la longueur de la mémoire tampon pointée par Buffer. La fonction remplace cette valeur par la taille réelle de la chaîne de nom de l’énumérateur. Si la longueur de mémoire tampon fournie par l’appelant est trop petite, la fonction fournit la taille de mémoire tampon requise et retourne CR_BUFFER_SMALL.

[in] ulFlags

Non utilisé, doit être égal à zéro.

[in, optional] hMachine

Handle de machine fourni par l’appelant, obtenu à partir d’un appel précédent à CM_Connect_Machine.

Note L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.

Remarques

Pour énumérer les énumérateurs d’appareils locaux ou distants, appelez CM_Enumerate_Enumerators_Ex plusieurs fois, en commençant par une valeur d’index ulEnumIndex égale à zéro et en incrémentant la valeur d’index à chaque appel suivant jusqu’à ce que la fonction retourne CR_NO_SUCH_VALUE.

Une fois les noms d’énumérateurs obtenus, ils peuvent être utilisés comme entrée pour CM_Get_Device_ID_List.

La fonctionnalité d’accès aux machines distantes a été supprimée dans Windows 8 et Windows Server 2012 et les systèmes d’exploitation ultérieurs. Vous ne pouvez donc pas accéder aux ordinateurs distants lorsque vous exécutez sur ces versions de Windows.

Configuration requise


Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib

Voir aussi

CM_Enumerate_Enumerators

Partager via