INodeProperties::GetProperty 方法 (mmc.h)

GetProperty 方法检索节点的仅文本属性值。 当基于 MMC 2.0 自动化对象模型的应用程序检索 Node.Property 属性时,将调用 INodeProperties::GetProperty 方法的实现。

语法

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

parameters

[in] pDataObject

指向管理单元数据对象的指针。

[in] szPropertyName

检索到的属性的名称。

[out] pbstrProperty

属性的文本值。

返回值

如果在调用此方法时提供属性值,则管理单元将返回 S_OK 。 如果管理单元返回 S_FALSE,则查询数据对象以获取属性值。

注解

扩展视图扩展使用两个属性:CCF_DESCRIPTION 和 CCF_HTML_DETAILS。 作为使用数据对象查询 CCF_DESCRIPTIONCCF_HTML_DETAILS 剪贴板格式为这些属性提供值的替代方法,管理单元可以使用 INodeProperties::GetProperty 将属性值返回到扩展视图。 当管理单元的数据对象未提供所需信息时,此替代方法非常有用。

除了提供CCF_DESCRIPTION和CCF_HTML_DETAILS属性值外,管理单元还可以使用 INodeProperties 为其他基于文本的属性提供值 (,例如,使用新的视图扩展) 。

有关详细信息和 INodeProperties::GetProperty 的代码示例,请参阅 使用扩展视图扩展 - 实现详细信息

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h

另请参阅

CCF_DESCRIPTION

CCF_HTML_DETAILS

Node

Node.Property

使用扩展视图扩展

使用扩展视图扩展 - 实现详细信息