Partilhar via


COleDocObjectItem::ExecCommand

Chamar essa função de membro para executar o comando especificado pelo usuário.

HRESULT ExecCommand(
   DWORD nCmdID,
   DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER,
   const GUID* pguidCmdGroup = NULL 
);

Parâmetros

  • nCmdID
    O identificador de comando para executar.Deve estar no grupo identificado por pguidCmdGroup.

  • nCmdExecOpt
    Opções de comando especifica execução.Por padrão, defina para executar o comando sem avisar o usuário.Consulte OLECMDEXECOPT para obter uma lista de valores.

  • pguidCmdGroup
    Identificador exclusivo do grupo de comando.Por padrão, NULO, que especifica o grupo padrão.O comando passado em nCmdID deve pertencer ao grupo.

Valor de retorno

Retorna se S_OK com êxito; caso contrário, retornará um dos seguintes códigos de erro.

Valor

Descrição

E_UNEXPECTED

Erro inesperado ocorreu.

E_FAIL

Erro ocorreu.

E_NOTIMPL

Indica que o MFC próprio deve tentar converter e distribuir o comando.

OLECMDERR_E_UNKNOWNGROUP

pguidCmdGroup éNULO não mas não especifica um grupo de comando reconhecido.

OLECMDERR_E_NOTSUPPORTED

nCmdID não é reconhecido como um comando válido no pGroup de grupo.

OLECMDERR_DISABLED

O comando identificado por nCmdID é desativado e não pode ser executado.

OLECMDERR_NOHELP

O chamador solicitado a ajuda no comando identificado pela nCmdID mas não há ajuda está disponível.

OLECMDERR_CANCELLED

o usuário cancelou a execução.

Comentários

pguidCmdGroup e parâmetros de nCmdID juntos identificam exclusivamente invocar o comando.O parâmetro de nCmdExecOpt especifica a ação exata executar.

Requisitos

Cabeçalho: afxole.h

Consulte também

Referência

Classe de COleDocObjectItem

Gráfico de hierarquia

IOleCommandTarget::Exec