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,以及下列值。

傳回碼 描述
S_OK
已成功傳回狀態資訊。
REGDB_E_CLASSNOTREG
未為類別物件註冊任何 CLSID。
REGDB_E_READREGDB
從登錄讀取時發生錯誤。
OLE_E_REGDB_KEY
登錄中遺漏 GetMiscStatus 機碼。

備註

物件應用程式可以透過兩種方式之一要求 OLE 取得其他狀態資訊。 其中一種方式是呼叫 OleRegGetMiscStatus。 另一個是傳回OLE_S_USEREG,以回應 IOleObject::GetMiscStatus的預設物件處理常式呼叫。 OLE_S_USEREG指示預設處理常式呼叫 OleRegGetMiscStatus。 因為 DLL 物件應用程式無法傳回OLE_S_USEREG,所以它們必須呼叫 OleRegGetMiscStatus ,而不是將作業委派給物件處理常式。

OleRegGetMiscStatus 及其同層級函式 OleRegGetUserTypeOleRegEnumFormatEtcOleRegEnumVerbs,提供一種方式,讓自訂 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 版)

另請參閱

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType