fonction CM_Set_Device_Interface_PropertyW (cfgmgr32.h)
La fonction CM_Set_Device_Interface_Property définit une propriété d’appareil d’une interface d’appareil.
Syntaxe
CMAPI CONFIGRET CM_Set_Device_Interface_PropertyW(
[in] LPCWSTR pszDeviceInterface,
[in] const DEVPROPKEY *PropertyKey,
[in] DEVPROPTYPE PropertyType,
[in] const PBYTE PropertyBuffer,
[in] ULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Paramètres
[in] pszDeviceInterface
Pointeur vers une chaîne qui identifie l’interface d’appareil instance pour laquelle définir une propriété.
[in] PropertyKey
Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété de la propriété d’interface d’appareil à 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é d’interface 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 propriété de la propriété d’interface de l’appareil. 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_Device_Interface_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 |