Compartilhar via

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

  • Artigo

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

Sintaxe

HRESULT Revoke(
  [in] DWORD dwRegister
);

Parâmetros

[in] dwRegister

O identificador da entrada ROT a ser revogada.

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG e S_OK.

Comentários

Esse método desfaz o efeito de uma chamada para IRunningObjectTable::Register, removendo o moniker e o ponteiro para o objeto identificado por esse moniker.

Anotações aos Chamadores

Um provedor de moniker (distribui monikers que identificam seus objetos para torná-los acessíveis a outras pessoas) deve chamar o método Revoke para revogar o registro de seus objetos quando ele parar de ser executado. Ele deve ter chamado anteriormente IRunningObjectTable::Register e armazenado o identificador retornado por esse método; ele usa esse identificador ao chamar Revoke.

O tipo mais comum de provedor de moniker é uma fonte de link de documento composto. Isso inclui aplicativos de servidor que dão suporte à vinculação a 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 escrevendo um aplicativo de contêiner, deverá revogar o registro de um documento quando o documento for fechado. Você também deve revogar o registro de um documento antes de registrá-lo novamente quando ele for renomeado.

Se você estiver escrevendo um aplicativo de servidor, deverá revogar o registro de um objeto quando o objeto for fechado. Você também deve revogar o registro de um objeto antes de registrá-lo novamente quando seu documento de contêiner for renomeado (consulte IOleObject::SetMoniker).

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 objidl.h

Confira também

Irunningobjecttable