Función GetRunningObjectTable (objbase.h)

Devuelve un puntero a la interfaz IRunningObjectTable en la tabla de objetos en ejecución local (ROT).

Sintaxis

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

Parámetros

[in] reserved

Este parámetro está reservado y debe ser 0.

[out] pprot

Dirección de una variable de puntero IRunningObjectTable* que recibe el puntero de interfaz al ROT local. Cuando la función se ejecuta correctamente, el autor de la llamada es responsable de llamar a Release en el puntero de interfaz. Si se produce un error, *pprot no está definido.

Valor devuelto

Esta función puede devolver los valores devueltos estándar E_UNEXPECTED y S_OK.

Comentarios

Cada estación de trabajo tiene un ROT local que mantiene una tabla de los objetos que se han registrado como ejecutándose en ese equipo. Esta función devuelve un puntero de interfaz IRunningObjectTable , que proporciona acceso a esa tabla.

Los proveedores de moniker, que entregan monikers que identifican objetos para que sean accesibles para otros usuarios, deben llamar a GetRunningObjectTable. Use el puntero de interfaz devuelto por esta función para registrar los objetos cuando empiecen a ejecutarse, para registrar las horas en que se modifican esos objetos y revocar sus registros cuando dejen de ejecutarse. Consulte la interfaz IRunningObjectTable para obtener más información.

Los orígenes de vínculos de documentos compuestos son el ejemplo más común de proveedores de moniker. Entre ellas se incluyen las aplicaciones de servidor que admiten la vinculación a sus documentos (o partes de un documento) y las aplicaciones de contenedor que admiten la vinculación a incrustaciones dentro de sus documentos. Las aplicaciones de servidor que no admiten la vinculación también pueden usar rot para cooperar con aplicaciones contenedoras que admiten la vinculación a incrustaciones.

Si va a implementar la interfaz IMoniker para escribir una nueva clase de moniker y necesita un puntero de interfaz a ROT, llame a IBindCtx::GetRunningObjectTable en lugar de a la función GetRunningObjectTable . Esto permite que las implementaciones futuras de la interfaz IBindCtx modifiquen el comportamiento del enlace.

Requisitos

Consulte también

IBindCtx::GetRunningObjectTable

Imoniker

IRunningObjectTable