iOpcPartSet::GetPart 方法 (msopc.h)

获取集中表示指定部件的部件对象。

语法

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

参数

[in] name

指向部件 URI 对象的 IOpcPartUri 接口的指针,该对象表示部件的部件名称。

[out, retval] part

指向部件对象的 IOpcPart 的指针,该部件对象代表具有指定部件名称的部件。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码/值 说明
S_OK
方法成功。
E_POINTER
name 参数为 NULL
OPC_E_NO_SUCH_PART
0x80510018
指定的部件不存在。
包消耗错误
包消耗错误组中HRESULT 错误代码。
部件 URI 错误
部件 URI 错误组中HRESULT 错误代码。

注解

若要检索表示特定部件的部件对象的 IOpcPart 接口指针,请调用 PartExists 方法并传入部件名称,以确认该部件在集中表示。 如果是,请调用 GetPart 方法并传入部件名称以检索 IOpcPart 接口指针。

如果部件 URI 对象表示 Relationships 部件的部件名称,则此方法将失败,因为关系部件不包含在集中。

IOpcPart 接口提供对部件属性的访问。 有关这些属性的详细信息,请参阅 部件概述IOpcPart

线程安全性

打包对象不是线程安全的。

有关详细信息,请参阅打包 API 的入门

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 msopc.h

另请参阅

使用打包 API 入门

IOpcPartSet

概述

打包 API 参考

打包 API 示例

打包错误

部件概述

引用