IOleUILinkInfoA

COM

継承元IOleUILinkContainerA自前メソッド開始 vtbl11

公式ドキュメント

IOleUILinkContainer インターフェースの拡張です。オブジェクトが最後に更新された時刻を返します。これは IOleUILinkContainer では提供されないリンク情報です。(ANSI)

解説(Remarks)

メモ

oledlg.h ヘッダーは IOleUILinkInfo を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義します。エンコーディング非依存のエイリアスの使用と、エンコーディング非依存でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が生じる可能性があります。詳細については、関数プロトタイプの規約を参照してください。

メソッド 1

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

vtbl 11 HRESULT GetLastUpdate(DWORD dwLink, FILETIME* lpLastUpdate)

オブジェクトが最後に更新された時刻を取得します。(ANSI)

dwLink	DWORD	in	単一のリンクに対してコンテナーが定義する一意の識別子です。コンテナーはこの値として、リンクのコンテナーサイトへのポインターを使用できます。
lpLastUpdate	FILETIME*	out	オブジェクトが最後に更新された時刻を示す FILETIME 構造体へのポインターです。

戻り値

成功した場合、このメソッドは S_OK を返します。その他に返される可能性のある値には、以下のものがあります。

戻り値	説明
E_ACCESSDENIED	アクセス権限が不足しています。
E_FAIL	操作に失敗しました。
E_INVALIDARG	指定された識別子が無効です。
E_OUTOFMEMORY	この操作に利用できるメモリが不足しています。

解説(Remarks)

実装者向けの注意

オブジェクトが最後に更新された時刻が判明している場合は、その値を lpLastUpdate にコピーしてください。判明していない場合は lpLastUpdate を変更せずにそのままにしてください。この場合、リンクページには「不明 (Unknown)」と表示されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

出力引数:

#define global IID_IOleUILinkInfoA "{}"
#usecom global IOleUILinkInfoA IID_IOleUILinkInfoA "{}"
#comfunc global IOleUILinkInfoA_GetLastUpdate  11 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IOleUILinkInfoA "{}"
#usecom global IOleUILinkInfoA IID_IOleUILinkInfoA "{}"
#comfunc global IOleUILinkInfoA_GetLastUpdate  11 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。