IMoniker：：GetTimeOfLastChange 方法 (objidl.h)

  • 發行項

擷取上次變更這個Moniker所識別物件的時間。

語法

HRESULT GetTimeOfLastChange(
  [in]  IBindCtx *pbc,
  [in]  IMoniker *pmkToLeft,
  [out] FILETIME *pFileTime
);

參數

[in] pbc

要用於這個系結作業之系結內容的指標。 系結內容會在系結程式期間快取系結的物件、包含使用系結內容套用至所有作業的參數，並提供Moniker實作應該擷取其環境相關信息的方法。 如需詳細資訊，請參閱 IBindCtx。

[in] pmkToLeft

如果Moniker是複合Moniker的一部分，則指向這個Moniker左邊的Moniker指標。 這個參數主要是由Moniker實作者用來啟用複合Moniker的各種元件之間的合作。 Moniker 用戶端應該傳遞 NULL。

[out] pFileTime

接收上次變更時間之 FILETIME 結構的指標。 {0xFFFFFFFF，0x7FFFFFFF} 的值表示錯誤 (例如超過時間限制、無法使用的資訊) 。

傳回值

這個方法可以傳回標準傳回值E_OUTOFMEMORY，以及下列值。

傳回碼 描述
S_OK
 已成功完成命令。
MK_E_EXCEEDEDDEADLINE
 系結作業無法在系結內容 BIND_OPTS 結構所指定的時間限制內完成。
MK_E_CONNECTMANUALLY
 作業無法連線到此物件的記憶體，可能是因為網路裝置無法連線。 如需詳細資訊，請參閱 IMoniker：：BindToObject。
MK_E_UNAVAILABLE
 變更的時間無法使用，無論使用的期限為何，都無法使用。

備註

精確來說，傳回的時間是 COM 最早可以識別之後未發生任何變更的時間，因此這次可能晚於上次變更對象的時間。

來電者附註

如果您要快取 Moniker 所識別的物件所傳回的資訊，您可能會想要確保資訊是最新的。 若要這樣做，您會呼叫 GetTimeOfLastChange ，並將傳回的時間與您上次從 物件擷取的信息時間進行比較。

針對儲存在連結物件內的 Moniker，GetTimeOfLastChange 主要是由默認處理程式的 IOleObject：：IsUpToDate 實作所呼叫。 容器應用程式會呼叫 IOleObject：：IsUpToDate 來判斷連結的物件 (或包含連結物件的內嵌物件，) 為最新狀態，而不會實際系結至物件。 這可讓應用程式快速判斷當使用者開啟檔時需要更新的連結物件。 然後，應用程式只能在提示用戶判斷是否應該更新) 而不是系結檔中每個鏈接物件之後，才需要更新 (這些鏈接物件。

實作者的注意事項

請務必快速執行這項作業，因為對於連結的物件，當使用者第一次開啟複合檔時會呼叫這個方法。 因此， GetTimeOfLastChange 實作 不應該系結至任何物件。 此外，您的實作應該檢查系結內容中的期限參數，並在指定的時間無法完成作業時傳回MK_E_EXCEEDEDDEADLINE。

以下是一些您可以在實作中使用的策略：

  • 對於許多類型的Moniker，pmkToLeft 參數會識別這個Moniker所識別物件的容器。 如果此為Moniker類別的 true，您可以直接在pmkToLeft 參數上呼叫 GetTimeOfLastChange，因為物件不能在其容器之後的日期變更。
  • 您可以在 ( ROT) 上呼叫 IBindCtx：：GetRunningObjectTable，然後呼叫 IRunningObjectTable：：GetTimeOfLastChange 來取得執行中對象數據表的指標，因為 ROT 通常會記錄上次變更的時間。
  • 您可以取得與此 Moniker 相關聯的記憶體 (或 pmkToLeft moniker) ，並使用 呼叫 IStorage：：Stat 傳回記憶體的上次修改時間。

實作特定附注

實作 備註
反Moniker 這個方法會傳回E_NOTIMPL。
類別Moniker 這個方法會傳回MK_E_UNAVAILABLE。
檔案Moniker 如果這個Moniker位於 ROT 中，這個方法會傳回該處註冊的最後一個變更時間;否則，它會傳回檔案的上次寫入時間。 如果找不到檔案，這個方法會傳回MK_E_NOOBJECT。
泛型複合Moniker 如果非 NULL) 和這個 Moniker，並使用 ROT 擷取上次變更的時間，這個方法會建立 pmkToLeft (的複合。 如果物件不在 ROT 中，方法會以遞歸方式在複合最右邊的元件上呼叫 GetTimeOfLastChange ，並傳遞複合的其餘部分做為該呼叫的 pmkToLeft 參數。
專案Moniker 如果 pmkToLeft 為 NULL，此方法會傳回MK_E_NOTBINDABLE。 否則，方法會建立 pmkToLeft 和這個 Moniker 的複合，並使用 ROT 來存取上次變更的時間。 如果物件不在 ROT 中，此方法會在 pmkToLeft 參數上呼叫 GetTimeOfLastChange。
OBJREF Moniker 這個方法會傳回E_NOTIMPL。
指標 Moniker 這個方法會傳回E_NOTIMPL。
URL Moniker 這個方法會傳回在 ROT 中註冊之物件上次變更的時間。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 objidl.h

另請參閱

IMoniker

IRunningObjectTable：：GetTimeOfLastChange