共用方式為

CoGetObject 函式 (objbase.h)

  • 發行項

將顯示名稱轉換成識別具名物件的Moniker，然後系結至Moniker所識別的物件。

語法

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

參數

[in] pszName

要建立之對象的顯示名稱。

[in, optional] pBindOptions

用來建立實際物件的Moniker的系結選項。 如需詳細資訊，請參閱 BIND_OPTS。 此參數可以是 Null。

[in] riid

要建立之對象上實作之介面標識符的參考。

[out] ppv

所建立物件上 riid 所指定介面的指標位址。

傳回值

此函式可以傳回標準傳回值E_FAIL、E_OUTOFMEMORY和E_UNEXPECTED，以及下列值。

傳回碼 描述
S_OK
 已成功建立物件。
MK_E_SYNTAX
 pszName 參數不是格式正確的顯示名稱。
MK_E_NOOBJECT
 找不到此Moniker所識別的物件，或這個Moniker所屬複合Moniker所識別的一些物件。
MK_E_EXCEEDEDDEADLINE
 系結作業無法在 pBindOptions 中傳遞的 BIND_OPTS 結構所指定的時間限制內完成。
MK_E_CONNECTMANUALLY
 系結作業需要終端用戶的協助。 傳回此值最常見的原因是需要密碼，或需要掛接磁碟驅動器。
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 找到中繼物件，但不支援完成系結作業所需的介面。 例如，如果專案Moniker不支援 IOleItemContainer 介面，則會傳回此值。

備註

CoGetObject 會封裝對 COM 連結庫函式 CreateBindCtx、 MkParseDisplayName 和 IMoniker：：BindToObject 的呼叫。

規格需求

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

另請參閱

BIND_OPTS