Méthode IFunctionInstance::OpenPropertyStore (functiondiscoveryapi.h)

Article
08/23/2023

[La découverte de fonctions peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Ouvre le magasin de propriétés pour la fonction instance. Le magasin de propriétés contient des métadonnées sur la fonction instance, telles que son nom, son icône, la date d’installation et d’autres informations.

Syntaxe

HRESULT OpenPropertyStore(
  [in]  DWORD          dwStgAccess,
  [out] IPropertyStore **ppIPropertyStore
);

Paramètres

[in] dwStgAccess

Mode d’accès à affecter au flux ouvert. Pour cette méthode, les modes d’accès suivants sont pris en charge :

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Pointeur vers un pointeur d’interface IPropertyStore .

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
STG_E_ACCESSDENIED	La méthode n’a pas pu ouvrir un magasin de propriétés accessible en écriture, car l’appelant a un accès insuffisant ou le fournisseur de découverte n’autorise pas l’accès en écriture à son magasin de propriétés.
E_INVALIDARG	La valeur de dwStgAccess n’est pas valide.
E_POINTER	Le ppIPropertyStore pointe vers une mémoire non valide.
E_OUTOFMEMORY	La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.

Notes

Un seul magasin de propriétés par fonction instance peut être ouvert à la fois. Si OpenPropertyStore est appelé deux fois sur la même fonction instance, les deux pointeurs ppIPropertyStore pointent vers le même magasin de propriétés. En outre, le mode d’accès (tel que spécifié par le paramètre dwStgAccess ) est déterminé par l’appel OpenPropertyStore le plus récent. Les applications doivent appeler Release pour fermer un magasin de propriétés avant d’en ouvrir un autre.

Il est possible qu’OpenPropertyStore retourne un magasin de propriétés pour un appareil qui a été supprimé. Dans ce cas, les clés de propriété dans le magasin seront vides. Cette situation peut se produire si le devnode de l’appareil a été supprimé, mais que le magasin de propriétés associé à la fonction de l’appareil instance est toujours accessible. Cette situation se produit rarement.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	functiondiscoveryapi.h
DLL	FunDisc.dll

Voir aussi

IFunctionInstance

Share via