fonction CM_Get_Device_ID_Size (cfgmgr32.h)

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

Syntaxe

CMAPI CONFIGRET CM_Get_Device_ID_Size(
  [out] PULONG  pulLen,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Paramètres

[out] pulLen

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

[in] dnDevInst

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

[in] ulFlags

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

Valeur de retour

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

Remarques

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

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

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

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

Exigences

Voir aussi

CM_Get_Child

CM_Get_Device_ID

CM_Get_Device_ID_Size_Ex