Win32 API 日本語リファレンス
ホーム › Storage.Packaging.Opc › IOpcRelationshipSet

IOpcRelationshipSet

COM
📘 Microsoft Learn (日本語) · English
IID42195949-3b79-4fc8-89c6-fc7fb979ee74継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetRelationship(LPWSTR relationshipIdentifier, IOpcRelationship** relationship)
relationshipIdentifierLPWSTRin取得するリレーションシップの識別子を指定する、NULL 終端のワイド文字列である。
relationshipIOpcRelationship**out指定した識別子に対応するリレーションシップ IOpcRelationship を受け取るポインタである。
vtbl 4 HRESULT CreateRelationship(LPWSTR relationshipIdentifier, LPWSTR relationshipType, IUri* targetUri, OPC_URI_TARGET_MODE targetMode, IOpcRelationship** relationship)
relationshipIdentifierLPWSTRin作成するリレーションシップの識別子を指定する、NULL 終端のワイド文字列である。NULL を渡すと識別子が自動生成される。
relationshipTypeLPWSTRin作成するリレーションシップの種類を表す型 URI を指定する、NULL 終端のワイド文字列である。
targetUriIUri*inリレーションシップの対象を指す URI を指定する IUri へのポインタである。
targetModeOPC_URI_TARGET_MODEin対象が内部パートか外部リソースかを示す OPC_URI_TARGET_MODE 値である。
relationshipIOpcRelationship**out作成されたリレーションシップ IOpcRelationship を受け取るポインタである。
vtbl 5 HRESULT DeleteRelationship(LPWSTR relationshipIdentifier)
relationshipIdentifierLPWSTRin削除するリレーションシップの識別子を指定する、NULL 終端のワイド文字列である。
vtbl 6 HRESULT RelationshipExists(LPWSTR relationshipIdentifier, BOOL* relationshipExists)
relationshipIdentifierLPWSTRin存在を確認するリレーションシップの識別子を指定する、NULL 終端のワイド文字列である。
relationshipExistsBOOL*out指定したリレーションシップが存在するかどうかを受け取る BOOL へのポインタである。
vtbl 7 HRESULT GetEnumerator(IOpcRelationshipEnumerator** relationshipEnumerator)
relationshipEnumeratorIOpcRelationshipEnumerator**outリレーションシップセット内の全リレーションシップを列挙する IOpcRelationshipEnumerator を受け取るポインタである。
vtbl 8 HRESULT GetEnumeratorForType(LPWSTR relationshipType, IOpcRelationshipEnumerator** relationshipEnumerator)
relationshipTypeLPWSTRin列挙対象を絞り込むリレーションシップの種類を表す型 URI を指定する、NULL 終端のワイド文字列である。
relationshipEnumeratorIOpcRelationshipEnumerator**out指定した種類のリレーションシップのみを列挙する IOpcRelationshipEnumerator を受け取るポインタである。
vtbl 9 HRESULT GetRelationshipsContentStream(IStream** contents)
contentsIStream**outリレーションシップ群を表すリレーションシップパートの内容を読み取る IStream を受け取るポインタである。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IOpcRelationshipSet "{42195949-3B79-4FC8-89C6-FC7FB979EE74}"
#usecom global IOpcRelationshipSet IID_IOpcRelationshipSet "{}"
#comfunc global IOpcRelationshipSet_GetRelationship                3 wstr,sptr
#comfunc global IOpcRelationshipSet_CreateRelationship             4 wstr,wstr,sptr,int,sptr
#comfunc global IOpcRelationshipSet_DeleteRelationship             5 wstr
#comfunc global IOpcRelationshipSet_RelationshipExists             6 wstr,var
#comfunc global IOpcRelationshipSet_GetEnumerator                  7 sptr
#comfunc global IOpcRelationshipSet_GetEnumeratorForType           8 wstr,sptr
#comfunc global IOpcRelationshipSet_GetRelationshipsContentStream  9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。