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

  • Article

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