OleCreateDefaultHandler 函式 (ole2.h)
建立預設內嵌處理程式的新實例。 這個實例會初始化,以便在內嵌物件進入執行中狀態時建立本地伺服器。
語法
HRESULT OleCreateDefaultHandler(
[in] REFCLSID clsid,
[in] LPUNKNOWN pUnkOuter,
[in] REFIID riid,
[out] LPVOID *lplpObj
);
參數
[in] clsid
CLSID,識別內嵌物件進入執行中狀態時要載入的 OLE 伺服器。
[in] pUnkOuter
如果要匯總處理程式,則為控制 IUnknown 介面的指標;如果未匯總,則為 NULL 。
[in] riid
介面識別碼的參考,通常IID_IOleObject,呼叫者會透過該標識碼與處理程序通訊。
[out] lplpObj
接收 riid 中所要求介面指標的指標變數位址。 成功傳回時,*ppvObj 會在新建立的處理程式上包含要求的介面指標。
傳回值
此函式會在成功時傳回 NOERROR,並支援標準傳回值E_OUTOFMEMORY。
備註
OleCreateDefaultHandler 會建立預設內嵌處理程式的新實例,初始化,以便在內嵌物件進入執行狀態時,建立 clsid 參數所識別的本地伺服器。 如果您要撰寫處理程式,而且想要使用默認處理程式的服務,請呼叫 OleCreateDefaultHandler。 當物件建立呼叫中指定的CLSID未註冊時,OLE也會在內部呼叫它。
如果指定的類別沒有特殊的處理程式, 則呼叫 OleCreateDefaultHandler 會產生與 呼叫 CoCreateInstance 函式的結果相同,而類別內容參數指派值CLSCTX_INPROC_HANDLER。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ole2.h |
程式庫 | Ole32.lib |
Dll | Ole32.dll |