GetRunningObjectTable
.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
Essa função fornece um ponteiro para o IRunningObjectTable interface sobre o local Running Object Table (ROT).
Syntax
WINOLEAPI GetRunningObjectTable(
DWORD reserved,
LPRUNNINGOBJECTTABLE* pprot
);
Parameters
- Reservado
[no] Reservado para uso futuro; Deve ser zero.
- pprot
[out] Endereço do IRunningObjectTablevariável * pointer que recebe o ponteiro interface para o local ROT. Quando a função for bem-sucedido, o chamador é responsável por chamado IUnknown::Release no ponteiro de interface. Se ocorrer um erro *pprot é indefinido.
Return Value
Essa função suporta o padrão valor de retorno E_UNEXPECTED, bem como o seguinte:
- S_OK
Um IRunningObjectTable ponteiro foi retornado com êxito.
Remarks
Cada estação de trabalho tem um local ROT que mantém uma tabela dos objetos que foram registrados como execução em que máquina. Essa função retorna um IRunningObjectTable ponteiro interface, que fornece acessar para essa tabela.
Moniker provedores, qual mão sem identificadores de origem que identifiquem os objetos de modo que eles seja acessível a outras pessoas, deve chamar GetRunningObjectTable.
Use o ponteiro interface retornado por essa função para o seguinte:
- Para registrar objetos quando eles começarem execução
- Para registro os horários em que esses objetos são modificados
- Para revogar seus registros quando eles parar execução
Veja a seção IRunningObjectTable interface para obter mais informações.
Documento composto link fontes são mais comum exemplo dos provedores moniker. Eles incluem aplicativos servidor que suporte vinculação a seus documentos (ou partes de um documento) e aplicativos contêiner que suporte vinculação a embeddings dentro de seus documentos.
Aplicativos de servidor que não podem de vinculação não suporte também utilizar o ROT Para cooperar com aplicativos contêiner que suporte vinculação a embeddings.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |