Marshal.FinalReleaseComObject(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParâ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.
o é null.
Comentários
O FinalReleaseComObject método libera a referência gerenciada a 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 a coleta de lixo.
O objeto COM não pode ser usado depois de ser 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.