Share via

Método IPropertyStore::GetCount (propsys.h)

  • Artigo

Esse método retorna uma contagem do número de propriedades anexadas ao arquivo.

Sintaxe

HRESULT GetCount(
  DWORD *cProps
);

Parâmetros

cProps

Um ponteiro para um valor que indica a contagem de propriedades.

Retornar valor

O IpropertyStore::GetCount método retorna um valor de S_OK quando a chamada é bem-sucedida, mesmo que o arquivo não tenha propriedades anexadas. Qualquer outro código retornado é um código de erro.

Comentários

IPropertyStore fornece uma abstração sobre uma matriz de chaves de propriedade por meio dos IPropertyStore::GetCount métodos E IPropertyStore::GetAt . As chaves de propriedade nessa matriz representam as propriedades armazenadas atualmente pelo IPropertyStore.

Quando GetCount for bem-sucedido, o valor apontado por cProps será uma contagem de chaves de propriedade na matriz. O chamador pode esperar que as chamadas para IPropertyStore::GetAt tenham êxito para valores de iProp menor que cProps.

No caso de falhas como E_OUTOFMEMORY, você deve definir cProps como zero. É preferível que os erros sejam descobertos durante a criação ou inicialização do repositório de propriedades.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível com o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho propsys.h
Biblioteca Propsys.idl
IRQL Todos os níveis

Confira também

Ipropertystore

IPropertyStore::GetAt