IMoniker：：BindToStorage 方法 (objidl.h)

系結至指定物件的記憶體。 不同於 IMoniker：：BindToObject 方法，這個方法不會啟用 Moniker 所識別的物件。

語法

HRESULT BindToStorage(
  [in]  IBindCtx *pbc,
  [in]  IMoniker *pmkToLeft,
  [in]  REFIID   riid,
  [out] void     **ppvObj
);

參數

[in] pbc

系結內容物件上 IBindCtx 介面的指標，用於這個系結作業。 系結內容會在系結程式期間快取系結的物件、包含套用至所有作業的參數，並提供Moniker實作應該擷取其環境相關信息的方法。

[in] pmkToLeft

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

[in] riid

所要求記憶體介面標識碼的參考，其指標將在 ppvObj 中傳回。 通常要求的記憶體介面包括 IStorage、 IStream 和 ILockBytes。

[out] ppvObj

接收 riid 中要求的介面指標的指標變數位址。 成功傳回時，*ppvObj 會包含Moniker所識別之物件記憶體的要求介面指標。 成功時，實作必須在記憶體上呼叫 AddRef 。 呼叫者必須負責呼叫 Release。 如果發生錯誤，*ppvObj 應該是 NULL。

傳回值

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

傳回碼	描述
S_OK	系結作業成功。
MK_E_NOSTORAGE	這個Moniker所識別的物件沒有它自己的記憶體。
MK_E_EXCEEDEDDEADLINE	系結作業無法在系結內容 BIND_OPTS 結構所指定的時間限制內完成。
MK_E_CONNECTMANUALLY	作業無法連線到記憶體，可能是因為網路裝置無法連線。 如需詳細資訊，請參閱 IMoniker：：BindToObject。
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED	找到中繼物件，但不支援完成系結作業所需的介面。 例如，如果專案Moniker不支援 IOleItemContainer 介面，則會傳回此值。
STG_E_ACCESSDENIED	無法存取記憶體物件。

 

這個方法也可以傳回與 IOleItemContainer：：GetObject 方法相關聯的錯誤。

備註

BindToObject 和 BindToStorage 方法之間有一個重要差異。 例如，如果您有識別電子表格物件的Moniker，呼叫 BindToObject 可提供電子表格物件本身的存取權，而呼叫 BindToStorage 則可讓您存取電子表格所在的儲存物件。

來電者的附註

雖然沒有任何 COM Moniker 類別在其系結作業中呼叫此方法，但可能適合在新的 Moniker 類別實作中呼叫此方法。 您可以在 BindToObject 的實作中呼叫這個方法，此實作需要 pmkToLeft 參數所識別之物件的資訊，而且可以在不啟用的情況下從物件的永續性記憶體中取得此方法。 例如，如果您的Monikers是用來識別可以啟動的物件，而不啟用其容器，您可能會發現此方法很有用。

用戶端可以讀取其Moniker識別之物件的記憶體，也可以呼叫這個方法。

實作者的注意事項

您的實作應該會找出目前Moniker所識別物件的永續性記憶體，並傳回所需的介面指標。 某些類型的Monikers代表虛擬物件，這些對像是沒有自己永續性記憶體的物件。 這類物件包含其容器內部狀態的一部分，例如電子錶格中的儲存格範圍。 如果您的Moniker類別識別此類型的物件， 則BindToStorage 的實作應該會傳回錯誤MK_E_NOSTORAGE。

如果系結內容BIND_OPTS結構指定BINDFLAGS_JUSTTESTEXISTENCE旗標，則實作可以選擇在 ppvObj (中傳回 NULL，不過您也可以忽略旗標並執行完整的系結作業) 。

實作特定附注

實作	備註
反Moniker	這個方法會傳回E_NOTIMPL。
類別Moniker	這個方法會轉送到Moniker的 BindToObject類別。
檔案Moniker	這個方法會開啟Moniker所代表路徑所指定的檔案，並傳回該檔案的 IStorage 指標。 方法僅支持系結至 IStorage 介面;如果在riid中要求IStream或ILockBytes，則此方法會傳回E_UNSPEC，如果要求其他介面，則此方法會傳回E_NOINTERFACE。 除非 pmkToLeft 是類別 Moniker， 否則 pmkToLeft 應該是 NULL，如同 IMoniker：：BindToObject 的實作一樣。
泛型複合Moniker	這個方法會以遞歸方式在複合的最右邊元件上呼叫 BindToStorage ，並將複合的其餘部分當做該呼叫的 pmkToLeft 參數傳遞。
專案Moniker	如果 pmkToLeft 為 NULL，這個方法會傳回E_INVALIDARG。 否則，方法會在 pmkToLeft 參數上呼叫 IMoniker：：BindToObject，要求 IOleItemContainer 介面指標。 方法接著會呼叫 要求的介面的 IOleItemContainer：：GetObjectStorage 。
OBJREF Moniker	這個方法會取得包含執行中物件之記憶體上所要求介面的封送處理指標。 因為 OBJREF Moniker 代表執行中的物件，所以不會進行啟用。 如果表示的物件不再執行， BindToStorage 會失敗並E_UNEXPECTED。
指標 Moniker	這個方法會查詢所要求介面的包裝指標。
URL Moniker	URL Monikers 的系統實作支援在所有 URL 上串流物件的 BindToStorage，以及在指定的資源是複合檔案的情況下，針對儲存物件使用 BindToStorage 。 因為 URL Moniker 支援異步系結，所以其 BindToStorage 的實際傳回值可能會因系結內容中建立的物件參數而有所不同。 不過，不論同步或異步使用方式為何，系結作業的語意都相同，如下所示： URL Moniker 會從系結內容提取系結作業的進一步資訊。 例如，Moniker 可以取得系結內容中註冊之 IBindStatusCallback 和 IEnumFORMATETC 介面的指標。 進一步的資訊可以包含透過 IBindCtx：：SetBindOptions 在系結內容上指定的其他系結選項，例如 dwTickCountDeadline 參數或 BIND_MAYBOTHERUSER的 grfFlags 值。 Moniker 接著會呼叫 IBindStatusCallback：：GetBindInfo ，並使用傳輸起始系結作業，並藉由呼叫 IBindStatusCallback：：OnStartBinding 將產生的 IBinding 傳遞至用戶端。 如果呼叫端在從 IBindStatusCallback：：GetBindInfo 擷取的 BINDINFO 結構中指定BINDF_ASYNCSTORAGE旗標，則 URL Moniker 會儘快傳回物件。 呼叫這些 IStorage 或 IStream 對象，這些物件參考尚未提供的數據會傳回E_PENDING。 如果呼叫端未如上所述指定異步 IStream 或 IStorage，URL Moniker 仍會透過 IBindStatusCallback：：OnDataAvailable 方法儘快傳回物件。 不過，對參考數據尚未提供之這些物件的呼叫將會封鎖，直到數據變成可用為止。 對於某些應用程式，這需要對現有 I/O 程式代碼進行最少修改，但仍可能會根據其存取模式來改善效能。

規格需求

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

另請參閱

IMoniker