Получение 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).

Параметры

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

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

В начало