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


Функция MMCPropPageCallback (mmc.h)

Функция MMCPropPageCallback требуется только оснасткам на основе классов Microsoft Foundation (MFC). Функция задает правильное состояние модуля во время создания страницы.

Синтаксис

HRESULT MMCPropPageCallback(
  void *vpsp
);

Параметры

vpsp

Указатель на структуру Microsoft Windows PROPSHEETPAGE . Имейте в виду, что по умолчанию MFC устанавливает собственный обратный вызов в члене pfnCallback структуры.

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

Эта функция обратного вызова может возвращать одно из этих значений.

Комментарии

Эта функция не должна вызываться оснастками, которые статически связывают библиотеки MFC. Вызов этой функции с помощью такой оснастки не будет правильно связываться.

Для каждой страницы, производной от CPropertyPagePage, вызовите MMCPropPageCallback с указателем на обратный вызов страницы, следуя приведенным ниже рекомендациям.

  • Все страницы для определенного листа свойств должны использовать один и тот же указатель обратного вызова.
  • Если вы замените обратный вызов MFC собственным, ваш обратный вызов должен вызвать обратный вызов MFC.
  • Эту функцию необходимо вызывать с каждым производным классом CPropertyPage .
MFC должно иметь правильное состояние модуля, заданное из экспортированных функций или COM-интерфейсов. Сюда входят вызовы, выполненные из операционной системы к модулю. Для экспортированных функций или COM-интерфейсов это делается путем добавления макроса AFX_MANAGE_STATE в начало всех экспортированных функций в библиотеках DLL оснастки, которые динамически связываются с MFC. Для этого в начало функций, экспортированных из оснастки, добавляется следующая строка кода:
AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Для вызова операционной системы MFC выполняет это автоматически. Так как страница свойств MMC не является MFC CPropertySheet, вызов операционной системы из-за обратного вызова находится в неправильном состоянии модуля. В результате необходимо убедиться, что состояние модуля правильно задано во время создания страницы. Это предназначение MMCPropPageCallback. После установки состояния модуля необходимо выполнить только AFX_MANAGE_STATE вызовы, предоставляемые COM-интерфейсами, реализованными оснасткой (например , IExtendPropertySheet2::CreatePropertyPages). Чтобы определить, имеет ли приложение правильное состояние модуля, просмотрите CWinApp и запишите имя приложения.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header mmc.h

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

PROPSHEETPAGE