CoRevokeMallocSpy

9/8/2008

Essa função revoga um registrado IMallocSpy WScript.Shell.

Syntax

HRESULT CoRevokeMallocSpy( );

Parameters

Nenhum.

Return Value

• S_OK
  O IMallocSpy objeto com êxito é revogado.

• CO_E_OBJNOTREG
  Nenhum espião atualmente está registrado.

• E_ACCESSDENIED
  Espião está registrado mas há pendente alocações (ainda não liberadas) feitas enquanto este espião estava ativo.

Remarks

O IMallocSpy objeto será liberado quando ele for revogado. Essa versão corresponde à chamar para IUnknown::AddRef Na implementação das Falha de QueryInterface função pela CoRegisterMallocSpy função. A implementação das IMallocSpy interface, em seguida, faça qualquer apropriado limpeza.

Se o código de retorno for E_ACCESSDENIED, há ainda pendente alocações que foram feitas enquanto o espião estava ativo. Neste maiúsculas e minúsculas, o espião registrado não pode ser revogado nesse tempo porque ele pode ter anexado cabeçalhos arbitrários e / ou marcadores para essas alocações que somente o espião conhece.

Do somente o espião PreFree (ou PreRealloc) método sabe como a conta para esses cabeçalhos e marcadores. Antes de retornar E_ACCESSDENIED, CoRevokeMallocSpy Anotações internamente que um revogar está pendente.

Quando o pendente alocações tiverem sido liberadas, o revogar continua automaticamente, liberando o IMallocSpy WScript.Shell. Portanto, é necessário chamar CoRevokeMallocSpy apenas uma vez para cada chamar para CoRegisterMallocSpy, mesmo se E_ACCESSDENIED é retornada.

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

See Also

Reference

COM Functions
CoGetMalloc