Метод IPropertyStore::GetCount (propsys.h)

  • Статья

Этот метод возвращает количество свойств, присоединенных к файлу.

Синтаксис

HRESULT GetCount(
  DWORD *cProps
);

Параметры

cProps

Указатель на значение, указывающее количество свойств.

Возвращаемое значение

Метод IpropertyStore::GetCount возвращает значение S_OK при успешном вызове, даже если у файла нет присоединенных свойств. Любой другой возвращаемый код является кодом ошибки.

Комментарии

IPropertyStore предоставляет абстракцию массива ключей свойств с помощью IPropertyStore::GetCount методов IPropertyStore::GetAt . Ключи свойств в этом массиве представляют свойства, которые в настоящее время хранятся в IPropertyStore.

При GetCount успешном выполнении значение, на которое указывает cProps, является числом ключей свойств в массиве. Вызывающий объект может ожидать успешного вызова IPropertyStore::GetAt для значений iProp меньше cProps.

В случае сбоев, таких как E_OUTOFMEMORY, необходимо задать для cProps нулевое значение. Желательно, чтобы ошибки обнаруживали во время создания или инициализации хранилища свойств.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционной системы Windows.
Целевая платформа Универсальное
Верхняя часть propsys.h
Библиотека Propsys.idl
IRQL Все уровни

См. также раздел

IPropertyStore

IPropertyStore::GetAt