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
| 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 |
| DLL | Cfgmgr32.dll |