共用方式為

IBindCtx：：GetObjectParam 方法 (objidl.h)

  • 發行項

擷取系結內容之指標字串索引鍵數據表中與指定索引鍵相關聯的物件介面指標。

語法

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

參數

[in] pszKey

要搜尋的 系結內容字串索引鍵 。 索引鍵字串比較會區分大小寫。

[out] ppunk

IUnknown* 指標變數的位址，該變數會接收與 pszKey 相關聯之對象的介面指標。 成功時，實作會呼叫 *ppunk 上的 AddRef。 呼叫者必須負責呼叫 Release。 如果發生錯誤，實作會將 *ppunk 設定為 NULL。

傳回值

如果方法成功，傳回值會S_OK。 否則會E_FAIL。

備註

系結內容會維護介面指標的數據表，每個數據表都與字串索引鍵相關聯。 這可讓您在Moniker實作與起始系結作業的呼叫端之間進行通訊。 一方可以在兩方已知的字串底下儲存介面指標，讓另一方稍後可以從系結內容擷取它。

此方法擷取的指標之前必須使用 IBindCtx：：RegisterObjectParam 方法插入數據表中。

來電者的附註

當系結作業無法取得所發生錯誤的特定資訊時，使用Moniker尋找其他物件可以呼叫此方法。 視錯誤而定，可能會更正情況並重試系結作業。 如需詳細資訊，請參閱 IBindCtx：：RegisterObjectParam 。

Moniker 實作可以呼叫這個方法，以處理呼叫端起始系結作業並要求特定信息的情況。 根據慣例，實作者應該使用以Moniker類別 CLSID 字串形式開頭的索引鍵名稱。 (請參閱 StringFromCLSID 函式.)

規格需求

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

另請參閱

IBindCtx