Método IMMDevice::OpenPropertyStore (mmdeviceapi.h)

  • Artículo

El método OpenPropertyStore recupera una interfaz en el almacén de propiedades del dispositivo.

Sintaxis

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

Parámetros

[in] stgmAccess

Modo de acceso de almacenamiento. Este parámetro especifica si se debe abrir el almacén de propiedades en modo de lectura, modo de escritura o modo de lectura y escritura. Establezca este parámetro en una de las siguientes constantes STGM:

STGM_READ

STGM_WRITE

STGM_READWRITE

El método permite que un cliente que se ejecute como administrador abra un almacén para acceso de solo lectura, de solo escritura o de lectura y escritura. Un cliente que no se ejecuta como administrador está restringido al acceso de solo lectura. Para obtener más información sobre las constantes STGM, consulte la documentación de Windows SDK.

[out] ppProperties

Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz IPropertyStore del almacén de propiedades del dispositivo. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a OpenPropertyStore , *ppProperties es NULL. Para obtener más información sobre IPropertyStore, consulte la documentación de Windows SDK.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_INVALIDARG
 El parámetro stgmAccess no es un modo de acceso válido.
E_POINTER
 El parámetro ppProperties es NULL.
E_OUTOFMEMORY
 Memoria insuficiente

Comentarios

En general, las propiedades del almacén de propiedades del dispositivo son de solo lectura para los clientes que no realizan funciones administrativas, del sistema o del servicio.

Para obtener ejemplos de código que llaman al método OpenPropertyStore , consulte los temas siguientes:

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mmdeviceapi.h

Consulte también

IMMDevice (interfaz)