Получение IPC-дескрипторов и идентификаторов служб...

Получение IPC-дескрипторов и идентификаторов служб для использования статически созданных IPC-каналов (sl_api.h)

27 января 2025

ID libkos_sl_api

API определен в заголовочном файле sysroot-*-kos/include/coresrv/sl/sl_api.h из состава KasperskyOS SDK.

API позволяет серверам получать слушающие дескрипторы, а клиентам получать клиентские IPC-дескрипторы и идентификаторы служб (RIIDs) для использования статически созданных IPC-каналов.

Закрытие полученного IPC-дескриптора приведет к недоступности IPC-канала. Если IPC-дескриптор был закрыт, то получить его повторно и восстановить доступ к IPC-каналу невозможно.

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

Функции sl_api.h

Функция

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

ServiceLocatorRegister()

Назначение

Позволяет получить слушающий дескриптор по имени IPC-канала.

Параметры

[in] channelName – указатель на имя IPC-канала.
[in] endpoints – фиктивный параметр (устарел). Должен иметь значение RTL_NULL.
[in] endpointsSize – фиктивный параметр (устарел). Должен иметь значение 0.
[out] id – фиктивный параметр (устарел).

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

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

ServiceLocatorConnect()

Назначение

Позволяет получить клиентский IPC-дескриптор по имени IPC-канала.

Параметры

[in] channelName – указатель на имя IPC-канала.

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

В случае успеха возвращает клиентский IPC-дескриптор, иначе возвращает INVALID_HANDLE.

ServiceLocatorGetRiid()

Назначение

Позволяет получить идентификатор службы (RIID).

Параметры

[in] handle – клиентский IPC-дескриптор.
[in] name – указатель на квалифицированное имя службы. О квалифицированном имени службы см. "Привязка методов моделей безопасности к событиям безопасности".

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

В случае успеха возвращает идентификатор службы (RIID), иначе возвращает INVALID_RIID. Тип возвращаемого значения определен в заголовочном файле sysroot-*-kos/include/nk/types.h из состава KasperskyOS SDK.

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

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

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