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 définissant son nombre de références sur 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 IntegerParamètres
- o
- Object
RcW à libérer.
Retours
Nouvelle valeur du nombre de références du RCW associé au o paramètre, qui est 0 (zéro) si la mise en production 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 récupéré par le garbage-collect.
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 après que son nombre de références devient 0, un InvalidComObjectException sera levée.
