Marshal.FinalReleaseComObject(Object) Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

Marshal.NoCom.cs

Libère toutes les références à un wrapper RCW (Runtime Callable Wrapper) en affectant la valeur 0 à son décompte de références.

public:
 static int FinalReleaseComObject(System::Object ^ o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> int

Public Shared Function FinalReleaseComObject (o As Object) As Integer

Paramètres

o

Object

Wrapper RCW à libérer.

Retours

Int32

Nouvelle valeur du décompte de références du wrapper RCW associé au paramètre o, qui est 0 (zéro) si la libération réussit.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentException

o n'est pas un objet COM valide.

ArgumentNullException

o a la valeur null.

Remarques

La FinalReleaseComObject méthode libère la référence managée à un objet COM. Appeler cette méthode revient à appeler la ReleaseComObject méthode dans une boucle jusqu’à ce qu’elle retourne 0 (zéro).

Lorsque le nombre de références sur l’objet COM devient 0, l’objet COM est généralement libéré, bien que cela dépend de l’implémentation de l’objet COM et soit hors de contrôle du runtime. Toutefois, le RCW peut toujours exister, en attendant d’être récupéré par la mémoire.

L’objet COM ne peut pas être utilisé une fois qu’il a été séparé de son RCW sous-jacent. Si vous essayez d’appeler une méthode sur le RCW une fois que son nombre de références devient 0, un InvalidComObjectException est levée.

Voir aussi

• ReleaseComObject(Object)
• NullReferenceException