fonction CM_Set_DevNode_PropertyW (cfgmgr32.h)
La fonction CM_Set_DevNode_Property définit une propriété de instance d’appareil.
Syntaxe
CMAPI CONFIGRET CM_Set_DevNode_PropertyW(
[in] DEVINST dnDevInst,
[in] const DEVPROPKEY *PropertyKey,
[in] DEVPROPTYPE PropertyType,
[in] const PBYTE PropertyBuffer,
[in] ULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Paramètres
[in] dnDevInst
Le instance de l’appareil qui est lié à l’ordinateur local.
[in] PropertyKey
Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété de l’appareil instance propriété à définir.
[in] PropertyType
Valeur de type DEVPROPTYPE qui représente l’identificateur de type de données de propriété pour la propriété instance de l’appareil. Pour supprimer une propriété, elle doit être définie sur DEVPROP_TYPE_EMPTY.
[in] PropertyBuffer
Pointeur vers une mémoire tampon qui contient la valeur de la propriété de l’appareil instance propriété. Si la propriété ou les données sont supprimées, ce pointeur doit avoir la valeur NULL et PropertyBufferSize doit avoir la valeur zéro.
[in] PropertyBufferSize
Taille, en octets, de la mémoire tampon PropertyBuffer . Si PropertyBuffer a la valeur NULL, PropertyBufferSize doit avoir la valeur zéro.
[in] ulFlags
Réservé. Doit être défini sur zéro.
Valeur retournée
Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.
Remarques
CM_Set_DevNode_Property fait partie du modèle de propriété d’appareil unifié.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows Vista et les versions ultérieures de Windows. |
| Plateforme cible | Universal |
| En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
| Bibliothèque | Cfgmgr32.lib |