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.Releases all references to a Runtime Callable Wrapper (RCW) by setting its reference count to 0.

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

Parâmetros

o
Object

O RCW a ser liberado.The RCW to be released.

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.The new value of the reference count of the RCW associated with the o parameter, which is 0 (zero) if the release is successful.

Atributos

Exceções

O o não é um objeto COM válido.o is not a valid COM object.

o é null.o is null.

Comentários

O método FinalReleaseComObject libera a referência gerenciada para um objeto COM.The FinalReleaseComObject method releases the managed reference to a COM object. Chamar esse método é equivalente a chamar o método ReleaseComObject em um loop até que ele retorne 0 (zero).Calling this method is equivalent to calling the ReleaseComObject method in a loop until it returns 0 (zero).

Quando a contagem de referência no objeto COM se torna 0, o objeto COM normalmente é liberado, embora isso dependa da implementação do objeto COM e está além do controle do tempo de execução.When the reference count on the COM object becomes 0, the COM object is usually freed, although this depends on the COM object's implementation and is beyond the control of the runtime. No entanto, o RCW ainda pode existir, aguardando para ser coletado pelo lixo.However, the RCW can still exist, waiting to be garbage-collected.

O objeto COM não pode ser usado depois de ter sido separado de seu RCW subjacente.The COM object cannot be used after it has been separated from its underlying RCW. Se você tentar chamar um método no RCW depois que sua contagem de referência se tornar 0, um InvalidComObjectException será lançado.If you try to call a method on the RCW after its reference count becomes 0, a InvalidComObjectException will be thrown.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a

Veja também