OleRegGetMiscStatus 函式 (ole2.h)
傳回登錄中指定 CLSID 所支援之簡報和行為的相關其他資訊。
自訂 DLL 物件應用程式的開發人員會使用此函式來模擬 OLE 預設處理常式的行為。
語法
HRESULT OleRegGetMiscStatus(
[in] REFCLSID clsid,
[in] DWORD dwAspect,
[out] DWORD *pdwStatus
);
參數
[in] clsid
要要求狀態資訊的 類別 CLSID。
[in] dwAspect
要求資訊之 類別的呈現層面。 可能的值取自 DVASPECT 列舉。
[out] pdwStatus
接收狀態資訊的變數指標。
傳回值
此函式可以傳回標準傳回值E_OUTOFMEMORY,以及下列值。
傳回碼 | 描述 |
---|---|
|
已成功傳回狀態資訊。 |
|
未為類別物件註冊任何 CLSID。 |
|
從登錄讀取時發生錯誤。 |
|
登錄中遺漏 GetMiscStatus 機碼。 |
備註
物件應用程式可以透過兩種方式之一要求 OLE 取得其他狀態資訊。 其中一種方式是呼叫 OleRegGetMiscStatus。 另一個是傳回OLE_S_USEREG,以回應 IOleObject::GetMiscStatus的預設物件處理常式呼叫。 OLE_S_USEREG指示預設處理常式呼叫 OleRegGetMiscStatus。 因為 DLL 物件應用程式無法傳回OLE_S_USEREG,所以它們必須呼叫 OleRegGetMiscStatus ,而不是將作業委派給物件處理常式。
OleRegGetMiscStatus 及其同層級函式 OleRegGetUserType、 OleRegEnumFormatEtc和 OleRegEnumVerbs,提供一種方式,讓自訂 DLL 物件應用程式的開發人員模擬 OLE 預設物件處理常式的行為,以從登錄取得物件的相關資訊。 藉由使用這些函式,您可以避免撰寫自己的大量工作,以及直接在登錄中運作時固有的陷阱。 此外,您不需要自行撰寫程式碼,即可取得這些函式的未來增強功能和優化。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ole2.h |
程式庫 | Ole32.lib |
Dll | Ole32.dll |
API 集合 | ext-ms-win-com-ole32-l1-1-3 (Windows 10 10.0.10240 版) |