MÉTHODE IMMDevice::OpenPropertyStore (mmdeviceapi.h)

Article
08/24/2023

La méthode OpenPropertyStore récupère une interface vers le magasin de propriétés de l’appareil.

Syntaxe

HRESULT OpenPropertyStore(
  [in]  DWORD          stgmAccess,
  [out] IPropertyStore **ppProperties
);

Paramètres

[in] stgmAccess

Mode d’accès au stockage. Ce paramètre spécifie s’il faut ouvrir le magasin de propriétés en mode lecture, en mode écriture ou en mode lecture/écriture. Définissez ce paramètre sur l’une des constantes STGM suivantes :

STGM_READ

STGM_WRITE

STGM_READWRITE

La méthode permet à un client s’exécutant en tant qu’administrateur d’ouvrir un magasin pour un accès en lecture seule, en écriture seule ou en lecture/écriture. Un client qui ne s’exécute pas en tant qu’administrateur est limité à l’accès en lecture seule. Pour plus d’informations sur les constantes STGM, consultez la documentation du Kit de développement logiciel (SDK) Windows.

[out] ppProperties

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IPropertyStore du magasin de propriétés de l’appareil. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel OpenPropertyStore échoue, *ppProperties a la valeur NULL. Pour plus d’informations sur IPropertyStore, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_INVALIDARG	Le paramètre stgmAccess n’est pas un mode d’accès valide.
E_POINTER	Le paramètre ppProperties a la valeur NULL.
E_OUTOFMEMORY	Mémoire insuffisante.

Notes

En règle générale, les propriétés du magasin de propriétés de l’appareil sont en lecture seule pour les clients qui n’effectuent pas de fonctions d’administration, de système ou de service.

Pour obtenir des exemples de code qui appellent la méthode OpenPropertyStore , consultez les rubriques suivantes :

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	mmdeviceapi.h

Voir aussi

IMMDevice Interface

Partager via