Метод ISpecifyPropertyPages::GetPages (ocidl.h)

Статья
03/05/2024

Извлекает список страниц свойств, которые могут отображаться на странице свойств этого объекта.

Синтаксис

HRESULT GetPages(
  [out] CAUUID *pPages
);

Параметры

[out] pPages

Указатель на структуру CAUUID , выделенную вызывающим объектом, которую функция инициализирует и заполняет перед возвратом. Элемент pElems в структуре выделяется функцией с CoTaskMemAlloc и должен быть освобожден вызывающим объектом с помощью CoTaskMemFree.

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

Этот метод может возвращать стандартные возвращаемые значения E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата	Описание
S_OK	Метод завершился успешно.
E_POINTER	Недопустимый адрес в pPages . Например, он может иметь значение NULL.

Структура CAUUID выделяется вызывающим объектом, но не инициализируется вызывающим объектом. Метод GetPages заполняет элемент cElements в структуре. Этот метод также выделяет память для массива, на который указывает элемент pElems с помощью CoTaskMemAlloc. Затем он заполняет только что выделенный массив. После успешного возврата этого метода структура содержит подсчитаемый массив идентификаторов UUID, каждый из которых указывает clSID страницы свойств.

Примечания к вызывающим абонентам

Вызывающий объект должен освободить память, на которую указывает член pElemsCAUUID, используя CoTaskMemFree , когда она больше не нужна.

Примечания для разработчиков

E_NOTIMPL не допускается в качестве возвращаемого значения, так как объект без страниц свойств не должен предоставлять интерфейс ISpecifyPropertyPages .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ocidl.h

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

ISpecifyPropertyPages

Поделиться через