Marshal.FinalReleaseComObject(Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Освобождает все ссылки на вызываемую оболочку среды выполнения (RCW), установив для нее значение 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 IntegerПараметры
- o
- Object
Выпуск RCW.
Возвращаемое значение
Новое значение счетчика ссылок rcW, связанного с o параметром, который равен 0 (ноль), если выпуск выполнен успешно.
- Атрибуты
Исключения
o недопустимый COM-объект.
o равно null.
Комментарии
Метод FinalReleaseComObject освобождает управляемую ссылку на COM-объект. Вызов этого метода эквивалентен вызову ReleaseComObject метода в цикле, пока он не возвращает значение 0 (ноль).
Когда число ссылок объекта COM становится 0, com-объект обычно освобождается, хотя это зависит от реализации COM-объекта и выходит за рамки контроля среды выполнения. Тем не менее, RCW по-прежнему может существовать, ожидая сборки мусора.
Объект COM нельзя использовать после того, как он был отделен от базового RCW. Если вы пытаетесь вызвать метод в RCW после того, как его число ссылок становится 0, InvalidComObjectException будет создано исключение.
