다음을 통해 공유

IOleCommandTarget::QueryStatus 메서드(docobj.h)

  • 아티클

사용자 인터페이스 이벤트를 통해 생성된 하나 이상의 명령의 상태를 개체에 쿼리합니다.

구문

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 구조체 배열입니다. 이 메서드는 각 구조체의 cmdf 멤버를 OLECMDF 열거형에서 가져온 값으로 채웁니다.

[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