共用方式為


docobj.) h (IOleCommandTarget::QueryStatus 方法

查詢物件由使用者介面事件產生的一個或多個命令的狀態。

語法

HRESULT QueryStatus(
  [in]      const GUID *pguidCmdGroup,
  [in]      ULONG      cCmds,
  [in, out] OLECMD []  prgCmds,
  [in, out] OLECMDTEXT *pCmdText
);

參數

[in] pguidCmdGroup

命令群組的唯一識別碼;可為 Null 以指定標準群組。 在 prgCmds陣列中傳遞的所有命令都必須屬於pguidCmdGroup所指定的群組。

[in] cCmds

prgCmds陣列中的命令數目。

[in, out] prgCmds

OLECMD結構的呼叫端配置陣列,表示呼叫端需要狀態資訊的命令。 這個方法會將取自OLECMDF列舉的值填入每個 結構的cmdf成員。

[in, out] pCmdText

OLECMDTEXT結構的指標,用來傳回單一命令的名稱和/或狀態資訊。 這個參數可以是 Null ,表示呼叫端不需要這項資訊。

傳回值

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

傳回碼 描述
E_FAIL
作業失敗。
E_UNEXPECTED
已發生未預期的錯誤。
E_POINTER
prgCmds引數為Null
OLECMDERR_E_UNKNOWNGROUP
pguidCmdGroup參數不是Null,但未指定已辨識的命令群組。

備註

呼叫端會使用 QueryStatus 來判斷目標物件支援哪些命令。 接著,呼叫端可以停用無法使用的命令,否則會路由傳送至 物件。 呼叫端也可以使用這個方法來取得單一命令的名稱或狀態。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 docobj.h

另請參閱

IOleCommandTarget

OLECMD

OLECMDF

OLECMDTEXT