Marshal.FinalReleaseComObject(Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Liberta todas as referências a um Runtime Callable Wrapper (RCW) definindo a sua contagem de referências para 0.
public:
static int FinalReleaseComObject(System::Object ^ o);[System.Security.SecurityCritical]
public static int FinalReleaseComObject(object o);public static int FinalReleaseComObject(object o);[<System.Security.SecurityCritical>]
static member FinalReleaseComObject : obj -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParâmetros
- o
- Object
O RCW será libertado.
Devoluções
O novo valor da contagem de referência do RCW associado ao o parâmetro, que é 0 (zero) se a libertação for bem-sucedida.
- Atributos
Exceções
o não é um objeto COM válido.
o é null.
Observações
O FinalReleaseComObject método liberta a referência gerida para um objeto COM. Chamar este método é equivalente a chamar o ReleaseComObject método num ciclo até que este retorne 0 (zero).
Quando a contagem de referências no objeto COM se torna 0, o objeto COM é geralmente libertado, embora isso dependa da implementação do objeto COM e esteja fora do controlo do tempo de execução. No entanto, o RCW ainda pode existir, à espera de ser recolhido no lixo.
O objeto COM não pode ser usado depois de ter sido separado do seu RCW subjacente. Se tentar chamar um método no RCW depois de a sua contagem de referências se tornar 0, será lançado a.InvalidComObjectException