Метод INodeProperties::GetProperty (mmc.h)

Статья
08/24/2023

Метод GetProperty извлекает текстовые значения свойств для узла. Ваша реализация метода INodeProperties::GetProperty вызывается, когда приложение, основанное на объектной модели MMC 2.0 Automation , получает свойство Node.Property .

Синтаксис

HRESULT GetProperty(
  [in]  LPDATAOBJECT pDataObject,
  [in]  BSTR         szPropertyName,
  [out] PBSTR        pbstrProperty
);

Параметры

[in] pDataObject

Указатель на объект данных оснастки.

[in] szPropertyName

Имя полученного свойства.

[out] pbstrProperty

Текстовое значение для свойства .

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

Оснастка возвращает S_OK , если она предоставляет значение свойства при вызове этого метода. Если оснастка возвращает S_FALSE, объект данных запрашивается для значения свойства.

Расширение расширенного представления использует два свойства: CCF_DESCRIPTION и CCF_HTML_DETAILS. В качестве альтернативы для предоставления значений для этих свойств с помощью объекта данных для запроса CCF_DESCRIPTION и CCF_HTML_DETAILS форматов буфера обмена оснастка может использовать INodeProperties::GetProperty для возврата значений свойств в расширенное представление. Эта альтернатива полезна в ситуациях, когда объект данных оснастки не предоставляет нужных сведений.

Помимо предоставления значений свойств CCF_DESCRIPTION и CCF_HTML_DETAILS, оснастка может использовать INodeProperties для предоставления значений для других текстовых свойств (например, с новым расширением представления).

Дополнительные сведения и пример кода для INodeProperties::GetProperty см. в разделе Использование расширения расширенного представления — сведения о реализации.

Требования


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