Отзыв дескрипторов

Поддержка

Поддержка KasperskyOS

KasperskyOS Community Edition

KasperskyOS API

Библиотека libkos

Управление дескрипторами (handle_api.h)

Отзыв дескрипторов

21 мая 2024

ID libkos_handles_revoke

Скачать PDF

Процесс может отозвать потомков дескриптора, которым он владеет. Отзыв дескрипторов осуществляется на основе дерева наследования дескрипторов.

Отзыв дескрипторов не закрывает их, но через отозванные дескрипторы невозможно обращаться к ресурсам. Любая функция, которая принимает дескриптор, завершается с ошибкой rcHandleRevoked, если эта функция вызвана с отозванным дескриптором.

Чтобы отозвать потомков дескриптора, нужно вызвать функцию KnHandleRevoke() или KnHandleRevokeSubtree(). Функция KnHandleRevokeSubtree() использует объект контекста передачи ресурса, который создается при передаче дескрипторов.

Если каждый из дескрипторов системного ресурса во всех процессах, которые владеют этими дескрипторами, будет закрыт (см. "Закрытие дескрипторов") или отозван, то этот системный ресурс будет удален.

Сведения о функциях API приведены в таблице ниже.

Функции handle_api.h

Функция	Сведения о функции
`KnHandleRevoke()`	Назначение Закрывает дескриптор и отзывает его потомков. Параметры [in] `handle` – дескриптор. Возвращаемые значения В случае успеха возвращает `rcOk`, иначе возвращает код ошибки.
`KnHandleRevokeSubtree()`	Назначение Отзывает дескрипторы, которые образуют поддерево наследования заданного дескриптора. Параметры [in] `handle` – дескриптор. Дескрипторы, образующие поддерево наследования этого дескриптора, отзываются. [in] `badge` – дескриптор, идентифицирующий объект контекста передачи ресурса, который определяет поддерево наследования дескрипторов для отзыва. Корневым узлом этого поддерева является дескриптор, который порожден передачей или копированием дескриптора, заданного через параметр `handle`, в ассоциации с объектом контекста передачи ресурса. Возвращаемые значения В случае успеха возвращает `rcOk`, иначе возвращает код ошибки.

Функция

Сведения о функции

KnHandleRevoke()

Назначение

Закрывает дескриптор и отзывает его потомков.

Параметры

[in] handle – дескриптор.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

KnHandleRevokeSubtree()

Назначение

Отзывает дескрипторы, которые образуют поддерево наследования заданного дескриптора.

Параметры

[in] handle – дескриптор. Дескрипторы, образующие поддерево наследования этого дескриптора, отзываются.
[in] badge – дескриптор, идентифицирующий объект контекста передачи ресурса, который определяет поддерево наследования дескрипторов для отзыва. Корневым узлом этого поддерева является дескриптор, который порожден передачей или копированием дескриптора, заданного через параметр handle, в ассоциации с объектом контекста передачи ресурса.

Возвращаемые значения

В случае успеха возвращает rcOk, иначе возвращает код ошибки.

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!