Compartilhar via


Interface IRunningObjectTable (objidl.h)

Gerencia o acesso à ROT (tabela de objetos em execução), uma tabela de pesquisa acessível globalmente em cada estação de trabalho. O ROT de uma estação de trabalho controla os objetos que podem ser identificados por um moniker e que estão em execução na estação de trabalho. Quando um cliente tenta associar um moniker a um objeto , o moniker verifica o ROT para ver se o objeto já está em execução; isso permite que o moniker se associe à instância atual em vez de carregar um novo.

Herança

A interface IRunningObjectTable herda da interface IUnknown . IRunningObjectTable também tem estes tipos de membros:

Métodos

A interface IRunningObjectTable tem esses métodos.

 
IRunningObjectTable::EnumRunning

Cria e retorna um ponteiro para um enumerador que pode listar os monikers de todos os objetos atualmente registrados na ROT (tabela de objetos em execução).
IRunningObjectTable::GetObject

Determina se o objeto identificado pelo moniker especificado está em execução e, se estiver, recupera um ponteiro para esse objeto.
IRunningObjectTable::GetTimeOfLastChange

Recupera a hora em que um objeto foi modificado pela última vez.
IRunningObjectTable::IsRunning

Determina se o objeto identificado pelo moniker especificado está em execução no momento.
IRunningObjectTable::NoteChangeTime

Registra a hora em que um objeto em execução foi modificado pela última vez. O objeto deve ter sido registrado anteriormente com a ROT (tabela de objetos em execução). Esse método armazena a hora da última alteração no ROT.
IRunningObjectTable::Register

Registra um objeto e seu moniker de identificação na ROT (tabela de objetos em execução).
IRunningObjectTable::Revoke

Remove uma entrada da ROT (tabela de objetos em execução) que foi registrada anteriormente por uma chamada para IRunningObjectTable::Register.

Comentários

O ROT contém entradas do seguinte formulário: (pmkObjectName, pUnkObject).

O elemento pmkObjectName é um ponteiro para o moniker que identifica o objeto em execução. O elemento pUnkObject é um ponteiro para o próprio objeto em execução. Durante o processo de associação, os monikers consultam as entradas pmkObjectName no ROT para ver se um objeto já está em execução.

Os objetos que podem ser nomeados por monikers devem ser registrados com o ROT quando são carregados e seu registro deve ser revogado quando eles não estão mais em execuçã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

Getrunningobjecttable

IBindCtx::GetRunningObjectTable

Irotdata