Método IRunningObjectTable::Revoke (objidl.h)

  • Artículo

Quita una entrada de la tabla de objetos en ejecución (ROT) que se registró anteriormente mediante una llamada a IRunningObjectTable::Register.

Sintaxis

HRESULT Revoke(
  [in] DWORD dwRegister
);

Parámetros

[in] dwRegister

Identificador de la entrada ROT que se va a revocar.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG y S_OK.

Comentarios

Este método deshace el efecto de una llamada a IRunningObjectTable::Register, quitando el moniker y el puntero al objeto identificado por ese moniker.

Notas a los autores de llamadas

Un proveedor de moniker (entrega monikers que identifican sus objetos para que sean accesibles para otros) debe llamar al método Revoke para revocar el registro de sus objetos cuando deja de ejecutarse. Debe haber llamado previamente a IRunningObjectTable::Register y almacenar el identificador devuelto por ese método; usa ese identificador al llamar a Revoke.

El tipo de proveedor de moniker más común es un origen de vínculo de documento compuesto. Esto incluye aplicaciones de servidor que admiten la vinculación a sus documentos (o partes de un documento) y 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 está escribiendo una aplicación contenedora, debe revocar el registro de un documento cuando se cierre el documento. También debe revocar el registro de un documento antes de volver a registrarlo cuando se cambie el nombre.

Si está escribiendo una aplicación de servidor, debe revocar el registro de un objeto cuando se cierre el objeto. También debe revocar el registro de un objeto antes de volver a registrarlo cuando se cambie el nombre de su documento contenedor (consulte IOleObject::SetMoniker).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

IRunningObjectTable