Marshal.FinalReleaseComObject(Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.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
Paramètres
- o
- Object
Wrapper RCW à libérer.
Retours
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
Exceptions
o
n'est pas un objet COM valide.
o
a la valeur null
.
Remarques
La FinalReleaseComObject méthode libère la référence managée à un objet COM. L’appel de cette méthode équivaut à 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 dépasse le contrôle du runtime. Toutefois, le RCW peut toujours exister, en attendant d’être collecté par le garbage-collected.
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 rcW une fois que son nombre de références devient 0, une InvalidComObjectException opération est levée.