SHCoCreateInstance 函式 (shlobj_core.h)

[SHCoCreateInstance 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 請改用 CoCreateInstance。]

(COM 建立元件物件模型，) 在 Shell32.dll 中實作的物件。

語法

SHSTDAPI SHCoCreateInstance(
  [in, optional] PCWSTR      pszCLSID,
  [in, optional] const CLSID *pclsid,
  [in, optional] IUnknown    *pUnkOuter,
  [in]           REFIID      riid,
  [out]          void        **ppv
);

參數

[in, optional] pszCLSID

類型： PCWSTR

要轉換成 CLSID 之字串的指標。 如果 為 NULL， 則會使用 pclsid 作為 CLSID。

[in, optional] pclsid

類型： const CLSID*

要建立的 CLSID。

[in, optional] pUnkOuter

類型： IUnknown*

外部 IUnknown 的指標。 用於匯總。

[in] riid

類型： REFIID

要透過 ppv 擷取之介面 IID 的參考。

[out] ppv

類型： void**

當此函式成功傳回時，接收 riid中要求的介面指標。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

建議您使用在 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。 此宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除 riid 中可能導致非預期結果的編碼錯誤的可能性。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)