CM_Get_Device_ID_Size, fonction (cfgmgr32.h)
La fonction CM_Get_Device_ID_Size récupère la taille de mémoire tampon requise pour contenir un ID de instance d’appareil pour un appareil instance sur l’ordinateur local.
Notes
Dans Windows Vista et les versions ultérieures de Windows, le modèle de propriété d’appareil unifié utilise la clé depropriété DEVPKEY_Device_InstanceId pour représenter l’identificateur de instance d’appareil. Pour plus d’informations, consultez Récupération d’un identificateur d’instance d’appareil.
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 de instance d’appareil fourni par l’appelant qui est lié à l’ordinateur local.
[in] ulFlags
Non utilisé, doit être égal à zéro.
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 doit être appelée pour déterminer la taille de mémoire tampon requise par CM_Get_Device_ID.
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 à l’ordinateur local, consultez CM_Get_Child.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib ; OneCoreUAP.lib sur Windows 10 |
| DLL | CfgMgr32.dll |