Compartilhar via


Marshal.FinalReleaseComObject(Object) Método

Definição

Libera todas as referências a um RCW (Runtime Callable Wrapper) definindo sua contagem de referência como 0.

public:
 static int FinalReleaseComObject(System::Object ^ o);
[System.Security.SecurityCritical]
public static int FinalReleaseComObject (object o);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);
public static int FinalReleaseComObject (object o);
[<System.Security.SecurityCritical>]
static member FinalReleaseComObject : obj -> int
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> int
static member FinalReleaseComObject : obj -> int
Public Shared Function FinalReleaseComObject (o As Object) As Integer

Parâmetros

o
Object

O RCW a ser liberado.

Retornos

O novo valor da contagem de referência do RCW associado ao parâmetro o, que será 0 (zero) se a versão for bem-sucedida.

Atributos

Exceções

O o não é um objeto COM válido.

Comentários

O FinalReleaseComObject método libera a referência gerenciada para um objeto COM. Chamar esse método é equivalente a chamar o ReleaseComObject método em um loop até que ele retorne 0 (zero).

Quando a contagem de referência no objeto COM se torna 0, o objeto COM geralmente é liberado, embora isso dependa da implementação do objeto COM e esteja além do controle do runtime. No entanto, o RCW ainda pode existir, aguardando para ser coletado como lixo.

O objeto COM não pode ser usado depois de ter sido separado de seu RCW subjacente. Se você tentar chamar um método no RCW depois que sua contagem de referência se tornar 0, um InvalidComObjectException será gerado.

Aplica-se a

Confira também