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 -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParamè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. 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.
