Método IPropertyStore::GetCount (propsys.h)
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 |