iOpcPartSet::GetPart 方法 (msopc.h)
获取集中表示指定部件的部件对象。
语法
HRESULT GetPart(
[in] IOpcPartUri *name,
[out, retval] IOpcPart **part
);
参数
[in] name
指向部件 URI 对象的 IOpcPartUri 接口的指针,该对象表示部件的部件名称。
[out, retval] part
指向部件对象的 IOpcPart 的指针,该部件对象代表具有指定部件名称的部件。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码/值 | 说明 |
---|---|
|
方法成功。 |
|
name 参数为 NULL。 |
|
指定的部件不存在。 |
|
包消耗错误组中的 HRESULT 错误代码。 |
|
部件 URI 错误组中的 HRESULT 错误代码。 |
注解
若要检索表示特定部件的部件对象的 IOpcPart 接口指针,请调用 PartExists 方法并传入部件名称,以确认该部件在集中表示。 如果是,请调用 GetPart 方法并传入部件名称以检索 IOpcPart 接口指针。
如果部件 URI 对象表示 Relationships 部件的部件名称,则此方法将失败,因为关系部件不包含在集中。
IOpcPart 接口提供对部件属性的访问。 有关这些属性的详细信息,请参阅 部件概述 和 IOpcPart。
线程安全性
打包对象不是线程安全的。
有关详细信息,请参阅打包 API 的入门。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | msopc.h |
另请参阅
概述
引用