共用方式為


IOleObject::GetMiscStatus 方法 (oleidl.h)

擷取物件在建立和載入時的狀態。

語法

HRESULT GetMiscStatus(
  [in]  DWORD dwAspect,
  [out] DWORD *pdwStatus
);

參數

[in] dwAspect

要要求狀態資訊之對象的層面。 此值是從列舉 DVASPECT 取得。

[out] pdwStatus

傳回狀態資訊之位置的指標。 此參數不可為 NULL

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
OLE_S_USEREG
將其他狀態資訊的擷取委派給默認處理程式的這個方法實作。
CO_E_CLASSNOTREG
對象沒有註冊 CLSID。
CO_E_READREGDB
存取登錄時發生錯誤。

備註

容器通常會在建立或載入物件時呼叫 IOleObject::GetMiscStatus ,以判斷如何顯示物件及其支持的行為類型。

物件會將狀態資訊儲存在登錄中。 如果物件未執行,默認處理程式的 IOleObject::GetMiscStatus 實作會從登錄擷取此資訊。 如果物件正在執行,默認處理程式會在物件本身叫用 IOleObject::GetMiscStatus

實際儲存在登錄中的資訊會隨著個別物件而有所不同。 要傳回的狀態值定義在列舉 OLEMISC 中。

如果找不到對應至指定 DVASPECT 的子機碼,則會使用 IOleObject::GetMiscStatus 的預設值。 若要設定 OLE 控制件,請指定 DVASPECT==1。 這會導致登錄中發生下列情況:

HKEY_CLASSES_ROOT\CLSID\ . . .
   MiscStatus = 1

實作者的注意事項

實作通常由委派預設處理程式的呼叫所組成。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

DVASPECT

FORMATETC

IOleObject

OLEMISC