Método IBindCtx::GetRunningObjectTable (objidl.h)

Recupera um ponteiro de interface para a ROT (tabela de objetos em execução) para o computador no qual esse contexto de associação está em execução.

Sintaxe

HRESULT GetRunningObjectTable(
  [out] IRunningObjectTable **pprot
);

Parâmetros

[out] pprot

O endereço de uma variável de ponteiro IRunningObjectTable* que recebe o ponteiro de interface para a tabela de objetos em execução. Se ocorrer um erro, *pprot será definido como NULL. Se *pprot não for NULL, a implementação chamará AddRef no objeto de tabela em execução; é responsabilidade do chamador chamar Release.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_OUTOFMEMORY, E_UNEXPECTED e S_OK.

Comentários

A tabela de objetos em execução é uma tabela acessível globalmente em cada computador. Ele controla todos os objetos que estão em execução no computador no momento.

Anotações para chamadores

Normalmente, aqueles que implementam uma nova classe moniker (por meio de uma implementação da interface IMoniker ) chamam GetRunningObjectTable. É útil chamar esse método em uma implementação de IMoniker::BindToObject ou IMoniker::IsRunning para marcar se um objeto está em execução no momento. Você também pode chamar esse método na implementação de IMoniker::GetTimeOfLastChange para saber quando um objeto em execução foi modificado pela última vez.

As implementações do Moniker devem chamar esse método em vez de usar a função GetRunningObjectTable . Isso possibilita que futuras implementações do IBindCtx modifiquem o comportamento de associação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	objidl.h

Confira também

Ibindctx

Imoniker

Irunningobjecttable