IOleObject::GetMiscStatus 方法 (oleidl.h)
擷取物件在建立和載入時的狀態。
語法
HRESULT GetMiscStatus(
[in] DWORD dwAspect,
[out] DWORD *pdwStatus
);
參數
[in] dwAspect
要要求狀態資訊之對象的層面。 此值是從列舉 DVASPECT 取得。
[out] pdwStatus
傳回狀態資訊之位置的指標。 此參數不可為 NULL。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
將其他狀態資訊的擷取委派給默認處理程式的這個方法實作。 |
|
對象沒有註冊 CLSID。 |
|
存取登錄時發生錯誤。 |
備註
容器通常會在建立或載入物件時呼叫 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 |