Método IRunningObjectTable::Revoke (objidl.h)
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 |