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

  • Artigo

O método OpenPropertyStore recupera uma interface para o repositório de propriedades do dispositivo.

Sintaxe

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

Parâmetros

[in] stgmAccess

O modo de acesso de armazenamento. Esse parâmetro especifica se o repositório de propriedades deve ser aberto no modo de leitura, no modo de gravação ou no modo de leitura/gravação. Defina esse parâmetro como uma das seguintes constantes STGM:

STGM_READ

STGM_WRITE

STGM_READWRITE

O método permite que um cliente em execução como administrador abra um repositório para acesso somente leitura, somente gravação ou leitura/gravação. Um cliente que não está em execução como administrador está restrito ao acesso somente leitura. Para obter mais informações sobre constantes STGM, consulte a documentação do SDK do Windows.

[out] ppProperties

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IPropertyStore do repositório de propriedades do dispositivo. Por meio desse método, o chamador obtém uma referência contada para a interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada OpenPropertyStore falhar, *ppProperties será NULL. Para obter mais informações sobre IPropertyStore, consulte a documentação do SDK do Windows.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Código de retorno Descrição
E_INVALIDARG
 O parâmetro stgmAccess não é um modo de acesso válido.
E_POINTER
 O parâmetro ppProperties é NULL.
E_OUTOFMEMORY
 Sem memória.

Comentários

Em geral, as propriedades no repositório de propriedades do dispositivo são somente leitura para clientes que não executam funções administrativas, de sistema ou de serviço.

Para obter exemplos de código que chamam o método OpenPropertyStore , consulte os seguintes tópicos:

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mmdeviceapi.h

Confira também

IMMDevice Interface