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

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

  • Статья

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

Синтаксис

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