COleServerDoc::OnExecOleCmd

HRESULT OnExecOleCmd ( const GUID * pGroup DWORD nCmdID DWORD nCmdExecOut, VARIANTARG * pvaIn VARIANTARG * pvaOut );

반환 값

성공 하면 S_OK 를 반환 합니다 다음 오류 코드 중 하나를, 그렇지 않으면:

매개 변수

pGroup

명령 집합을 식별 하는 GUID에 대 한 포인터입니다. NULL 을 나타내는 기본 명령 그룹 수 있습니다.

nCmdID

실행할 명령입니다. PGroup 에 의해 식별 된 그룹에 있어야 합니다.

nCmdExecOut

방법 개체 명령, 하나 이상의 다음 값의 OLECMDEXECOPT 열거형에서 실행 해야:

OLECMDEXECOPT_DODEFAULT

OLECMDEXECOPT_PROMPTUSER

OLECMDEXECOPT_DONTPROMPTUSER

OLECMDEXECOPT_SHOWHELP

pvaIn

VARIANTARG 명령에 대 한 입력된 인수를 포함 하는 포인터입니다. NULL 이 될 수 있습니다.

pvaOut

출력을 받을 수 VARIANTARG 에 대 한 포인터 명령에서 값을 반환 합니다. NULL 이 될 수 있습니다.

주의

지정 된 명령을 실행 또는 명령에 대 한 도움말을 표시 하려면이 함수를 호출 하는 프레임 워크。

COleCmdUI 설정, 업데이트, 및 DocObject 사용자 인터페이스 명령의 다른 속성을 설정할 사용할 수 있습니다. 명령은 초기화 후 OnExecOleCmd 와 함께 그들을 실행할 수 있습니다.

프레임 워크 번역 하 고 OLE 문서 명령을 전달 하기 전에 해당 함수를 호출 합니다. 표준 OLE 문서 명령을 처리 하려면이 함수를 재정의할 필요가 없습니다 있지만 사용자 지정 명령을 처리 하거나 매개 변수를 수락 하거나 결과 반환 하는 명령을 처리 하려면이 함수를 재정의 제공 해야 합니다.

대부분의 명령 인수 하지 않거나 값을 반환 합니다. 대부분의 명령에 대 한 호출자는 pvaIn 및 pvaOut에 대 한 NULLs를 전달할 수 있습니다. 입력된 값을 예상 하는 명령에 대 한 호출자가 VARIANTARG 변수 초기화 및 pvaIn변수에 대 한 포인터 전달 선언 수 있습니다. 단일 값을 필요로 하는 명령에 대 한 인수를 VARIANTARG 에 직접 저장 하 고이 함수에 전달 된 수 있습니다. ( IDispatch 및 SAFEARRAY )와 같은 지원 되는 형식 중 하나를 사용 하 여 VARIANTARG 내에서 여러 인수를 포장 해야 합니다.

마찬가지로, 명령 인수를 반환 하는 경우 호출자에 게 VARIANTARG선언 VT_EMPTY를 초기화 하 고 pvaOut에 해당 주소를 전달할 것으로 예상 된다. 명령을 단일 값을 반환 하는 경우 개체를 pvaOut에서 직접 해당 값을 저장할 수 있습니다. 어떤 방법으로 VARIANTARG 에 대 한 적절 한 여러 출력 값을 패키지。

이 함수의 기본 클래스 구현 명령 대상와 관련 된 OLE_COMMAND_MAP 구조를 산책 하 고 적절 한 처리기에 명령을 전달 하려고 합니다. 기본 클래스 구현 명령 인수 또는 반환 값에만 사용할 수 있습니다. 이 함수를 재정의 하 고 자신 pvaIn 및 pvaOut 매개 변수를 사용 해야 합니다 명령 인수를 수락 하거나 반환 값을 처리 해야 하는 경우。

COleServerDoc 개요 |nbsp; 클래스 멤버 (ko) | 계층 구조 차트(&N)

참고 항목nbsp;COleCmdUI(&N)