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

[A Descoberta de Funções está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Abre o repositório de propriedades da instância de função. O repositório de propriedades contém metadados sobre a instância de função, como seu nome, ícone, data de instalação e outras informações.

Sintaxe

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

Parâmetros

[in] dwStgAccess

O modo de acesso a ser atribuído ao fluxo aberto. Para esse método, há suporte para os seguintes modos de acesso:

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Um ponteiro para um ponteiro de interface IPropertyStore .

Valor retornado

Os valores retornados possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
STG_E_ACCESSDENIED	O método não pôde abrir um repositório de propriedades gravável porque o chamador não tem acesso suficiente ou o provedor de descoberta não permite acesso de gravação ao repositório de propriedades.
E_INVALIDARG	O valor de dwStgAccess é inválido.
E_POINTER	O ppIPropertyStore aponta para memória inválida.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.

Comentários

Somente um repositório de propriedades por instância de função pode ser aberto por vez. Se OpenPropertyStore for chamado duas vezes na mesma instância de função, ambos os ponteiros ppIPropertyStore apontarão para o mesmo repositório de propriedades. Além disso, o modo de acesso (conforme especificado pelo parâmetro dwStgAccess ) seria determinado pela chamada openPropertyStore mais recente. Os aplicativos devem chamar Release para fechar um repositório de propriedades antes de abrir outro.

É possível que OpenPropertyStore retorne um repositório de propriedades para um dispositivo que foi removido. Nesse caso, as chaves de propriedade no repositório estarão vazias. Essa situação poderá ocorrer se o devnode do dispositivo tiver sido excluído, mas o repositório de propriedades associado à instância de função do dispositivo ainda estiver acessível. Essa situação raramente ocorre.

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	functiondiscoveryapi.h
DLL	FunDisc.dll

Confira também

IFunctionInstance