IRunnableObject::Run
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método é executado um objeto.
Syntax
HRESULT Run(
LPBC lpbc
);
Parameters
- lpbc
[no] Ponteiro para o contexto de ligação da executar operação. Pode ser NULL.
Return Value
Este método oferece suporte a padrão retornar valores E_OUTOFMEMORY e E_UNEXPECTED, bem como o seguinte:
- S_OK
O objeto foi colocado com êxito na execução estado.
Remarks
Chamar recipientes IRunnableObject::Run Para forçar seus objetos para inserir a execução estado.
Se o objeto não for chamado, execução IRunnableObject::Run Pode ser uma operação cara, sobre a ordem do número de segundos.
Se o objeto é execução, esse método não tem nenhum efeito sobre o objeto.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Notas para chamadores
Quando chamado em um objeto vinculado que foi convertido para uma nova classe desde que o link foi última ativado, IRunnableObject::Run Retornar OLE_E_CLASSDIFF. Neste maiúsculas e minúsculas, o cliente deve chamar IOleLink::BindToSource.
OleRun é um função de ajuda que repackages convenientemente a funcionalidade oferecida por IRunnableObject::Run.
Com a versão de OLE 2.01, a implementação de OleRun foi alterado para que ele chama Falha de QueryInterface, solicita IRunnableObjecte em seguida, chama IRunnableObject::Run. Em outras palavras, você pode usar a interface e a função de ajuda de forma intercambiável.
Notas para Implementers
O objeto deve registrar na execução tabela objeto se ele tiver um moniker atribuído. O objeto não deve manter qualquer bloqueios de alta segurança em si; Em vez disso, ele deve permanecer no estado instável, desbloqueado. O objeto deve ser bloqueado quando o primeiro externo conexão é feita para o objeto.
Um objeto incorporado deve manter um bloqueio na sua incorporação contêiner enquanto ele estiver na execução estado.
O manipulador padrão fornecida pelo OLE 2 cuida dos bloqueando a incorporação contêiner on Behalf Of objetos implementados por um aplicativo objeto EXE.
Objetos implementados por um aplicativo deve explicitamente pôr DLL objeto um bloqueio em seus incorporação recipientes, que eles feito pelo primeiro chamado IOleClientSite::GetContainer Para get um ponteiro para o contêiner, em seguida, chamado IOleContainer::LockContainer Para realmente local o bloqueio. Esse bloqueio deve ser liberado quando IOleObject::Close é chamado.
Requirements
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |