COleServerDoc::OnExecOleCmd
프레임 워크는 지정 된 명령을 실행 하거나 명령 도움말을 표시 하려면이 함수를 호출 합니다.
virtual HRESULT OnExecOleCmd(
const GUID* pguidCmdGroup,
DWORD nCmdID,
DWORD nCmdExecOpt,
VARIANTARG* pvarargIn,
VARIANTARG* pvarargOut
);
매개 변수
pguidCmdGroup
명령 집합을 식별 하는 GUID에 대 한 포인터입니다.수 NULL 기본 명령 그룹을 나타냅니다.nCmdID
실행할 명령입니다.그룹을 식별 해야 pguidCmdGroup.nCmdExecOut
명령, 하나 이상의 다음 값에서 개체는 실행의 OLECMDEXECOPT 열거:OLECMDEXECOPT_DODEFAULT
OLECMDEXECOPT_PROMPTUSER
OLECMDEXECOPT_DONTPROMPTUSER
OLECMDEXECOPT_SHOWHELP
pvarargIn
포인터는 VARIANTARG 명령 입력된 인수가 포함 된.수 NULL.pvarargOut
포인터는 VARIANTARG 명령에서 출력이 반환 값을 받을 수 있습니다.수 NULL.
반환 값
반환 S_OK 성공 하면. 그렇지 않은 경우 다음 오류 코드 중:
값 |
설명 |
|---|---|
E_UNEXPECTED |
예기치 않은 오류가 발생 했습니다. |
E_FAIL |
오류가 발생 했습니다. |
E_NOTIMPL |
MFC를 나타내는 자체 변환 및 명령을 전달 해서는 |
OLECMDERR_E_UNKNOWNGROUP |
pguidCmdGroup비입니다-NULL 인식 된 명령 그룹을 지정 하지 않 |
OLECMDERR_E_NOTSUPPORTED |
nCmdID그룹에 유효한 명령으로 인식 되지 않습니다.pguidCmdGroup |
OLECMDERR_DISABLED |
식별 명령 nCmdID 사용 하지 않고 실행 될 수 없습니다. |
OLECMDERR_NOHELP |
호출자에 게 요청에 대 한 도움말으로 명령에서 nCmdID 있지만 도움말을 사용할 수 없습니다. |
OLECMDERR_CANCELED |
사용자는 실행 취소 |
설명
COleCmdUI설정, 업데이트 및 기타 DocObject 사용자 인터페이스 명령 속성을 설정 하려면 사용할 수 있습니다.명령을 초기화 된 후에 실행할 수 있습니다 OnExecOleCmd.
번역 하는 OLE 문서 명령 발송 하기 전에 함수를 호출 하는 프레임 워크.표준 OLE 문서 명령을 처리 하려면이 함수를 재정의할 필요는 없지만 사용자 지정 명령을 처리 하거나 매개 변수를 사용 하거나 결과 반환 하는 명령을 처리 하려면이 함수를 재정의 해야 합니다.
대부분의 명령 인수를 사용 하지 않거나 값을 반환 합니다.대부분의 명령에 대 한 호출자에 게 전달할 수 있습니다 NULLs pvarargIn 및 pvarargOut.입력된 값을 예상 하는 명령 호출자 선언 및 초기화 수는 VARIANTARG 변수는 포인터 변수를 전달 하 고 pvarargIn.단일 값이 필요한 명령에 인수를 직접 저장할 수 있는 VARIANTARG 함수에 전달 하 고.내 여러 인수를 패키지 해야는 VARIANTARG 지원 되는 형식 중 하나를 사용 하 여 (같은 IDispatch 및 SAFEARRAY ).
명령 인수를 호출자에 게 반환 하는 경우 마찬가지로 선언으로 예상 되는 VARIANTARG, 초기화를 VT_EMPTY, 주소를 전달 하 고 pvarargOut.명령을 단일 값을 반환 하는 경우, 개체에서 직접 해당 값을 저장할 수 있습니다 pvarargOut.여러 출력 값에 대 한 적절 한 방식으로 패키지화 되어야 합니다의 VARIANTARG.
이 함수의 기본 클래스 구현을 안내는 OLE_COMMAND_MAP 구조 관련 명령 대상 및 명령에는 적절 한 처리기를 발송 하려고 합니다.기본 클래스 구현은 인수를 허용 하지 않거나 값을 반환 하는 명령에만 사용할 수 있습니다.인수를 허용 하지 않거나 값을 반환 하는 명령을 처리 하는 경우이 함수를 재정의 하 여 작업 해야는 pvarargIn 및 pvarargOut 매개 변수에 직접.
요구 사항
헤더: afxole.h