CM_Get_Device_ID_Size_Ex, fonction (cfgmgr32.h)

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

La fonction CM_Get_Device_ID_Size_Ex récupère la taille de mémoire tampon requise pour contenir un ID de instance d’appareil pour un appareil instance sur un ordinateur local ou distant.

Syntaxe

CMAPI CONFIGRET CM_Get_Device_ID_Size_Ex(
  [out]          PULONG   pulLen,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Paramètres

[out] pulLen

Reçoit une valeur représentant la taille de mémoire tampon requise, en caractères.

[in] dnDevInst

Handle de instance d’appareil fourni par l’appelant qui est lié à l’ordinateur local.

[in] ulFlags

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

[in, optional] hMachine

Handle de machine fourni par l’appelant auquel le handle de instance d’appareil fourni par l’appelant est lié.

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

La fonction CM_Get_Device_ID_Size_Ex doit être appelée pour déterminer la taille de mémoire tampon requise par CM_Get_Device_ID_Ex.

La valeur de taille fournie à l’emplacement vers lequel pulLen pointe est inférieure à MAX_DEVICE_ID_LEN et n’inclut pas la valeur NULL de fin de la chaîne d’identificateur. Si le instance d’appareil spécifié n’existe pas, la fonction fournit une valeur de taille égale à zéro.

Pour plus d’informations sur les ID de instance d’appareil, consultez Chaînes d’identification d’appareil.

Pour plus d’informations sur l’utilisation de handles de instance d’appareil liés à un ordinateur local ou distant, consultez CM_Get_Child_Ex.

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

Voir aussi

CM_Get_Child_Ex

CM_Get_Device_ID_Ex

CM_Get_Device_ID_Size