Função GetRunningObjectTable (objbase.h)

  • Artigo

Retorna um ponteiro para a interface IRunningObjectTable na ROT (tabela de objetos em execução local).

Sintaxe

HRESULT GetRunningObjectTable(
  [in]  DWORD                reserved,
  [out] LPRUNNINGOBJECTTABLE *pprot
);

Parâmetros

[in] reserved

Esse parâmetro é reservado e deve ser 0.

[out] pprot

O endereço de uma variável de ponteiro IRunningObjectTable* que recebe o ponteiro de interface para o ROT local. Quando a função é bem-sucedida, o chamador é responsável por chamar Release no ponteiro da interface. Se ocorrer um erro, *pprot será indefinido.

Retornar valor

Essa função pode retornar os valores retornados padrão E_UNEXPECTED e S_OK.

Comentários

Cada estação de trabalho tem uma ROT local que mantém uma tabela dos objetos que foram registrados como em execução nesse computador. Essa função retorna um ponteiro de interface IRunningObjectTable , que fornece acesso a essa tabela.

Os provedores moniker, que distribuim monikers que identificam objetos para que eles sejam acessíveis a outras pessoas, devem chamar GetRunningObjectTable. Use o ponteiro de interface retornado por essa função para registrar seus objetos quando eles começarem a ser executados, para registrar os horários em que esses objetos são modificados e revogar seus registros quando eles pararem de ser executados. Consulte a interface IRunningObjectTable para obter mais informações.

As fontes de link de documento composto são o exemplo mais comum de provedores de moniker. Isso inclui aplicativos de servidor que dão suporte à vinculação a seus documentos (ou partes de um documento) e aplicativos de contêiner que dão suporte à vinculação a inserções em seus documentos. Aplicativos de servidor que não dão suporte à vinculação também podem usar o ROT para cooperar com aplicativos de contêiner que dão suporte à vinculação a inserções.

Se você estiver implementando a interface IMoniker para gravar uma nova classe de moniker e precisar de um ponteiro de interface para o ROT, chame IBindCtx::GetRunningObjectTable em vez da função GetRunningObjectTable . Isso permite que implementações futuras da interface IBindCtx modifiquem o comportamento da associação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objbase.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-0 (introduzido no Windows 8)

Confira também

IBindCtx::GetRunningObjectTable

Imoniker

Irunningobjecttable