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

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

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

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.

Функция

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

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.

Идентификатор статьи: libkos_sl_api, Последнее изменение: 27 янв. 2025 г.

В начало