Compartilhar via

Método IPropertyStoreFactory::GetPropertyStoreForKeys (propsys.h)

  • Artigo

Obtém um objeto IPropertyStore , dado um conjunto de chaves de propriedade. Isso fornece um método alternativo, possivelmente mais rápido, de obter um objeto IPropertyStore em comparação com chamar IPropertyStoreFactory::GetPropertyStore.

Sintaxe

HRESULT GetPropertyStoreForKeys(
  [in]  const PROPERTYKEY     *rgKeys,
  [in]  UINT                  cKeys,
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Parâmetros

[in] rgKeys

Tipo: const PROPERTYKEY*

Um ponteiro para uma matriz de estruturas PROPERTYKEY .

[in] cKeys

Tipo: UINT

O número de estruturas PROPERTYKEY na matriz apontada por rgKeys.

[in] flags

Tipo: GETPROPERTYSTOREFLAGS

Valores GETPROPERTYSTOREFLAGS que modificam o repositório retornado.

[in] riid

Tipo: REFIID

Uma referência ao IID do objeto a ser criado.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o endereço de um ponteiro de interface IPropertyStore .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

É recomendável que você use a macro IID_PPV_ARGS, definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Requisitos

Requisito Valor
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 propsys.h