Функция SLGetServiceInformation (slpublic.h)

Возвращает сведения о глобальных данных.

Синтаксис

HRESULT SLGetServiceInformation(
  [in]            HSLC       hSLC,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Параметры

[in] hSLC

Тип: HSLC

Дескриптор текущего контекста SLC.

[in] pwszValueName

Тип: PCWSTR

Имя, связанное с извлекаемым значением. Допустимы следующие имена.

Значение	Значение
SL_INFO_KEY_VERSION L"Version"	Версия службы SL. Например, "1.2.3.4"
SL_INFO_KEY_SYSTEM_STATE L"SystemState"	Состояние системы
SL_INFO_KEY_ACTIVE_PLUGINS L"ActivePlugins"	Полные пути DLL для всех активных подключаемых модулей (с разделителями NULL и двойными значениями NULL).
SL_INFO_KEY_SECURE_STORE_ID L"SecureStoreId"	Идентификатор безопасного хранилища (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID L"SessionMachineId"	Идентификатор сеансового компьютера (двоичный BLOB- объект)

[out, optional] peDataType

Тип: SLDATATYPE*

Указатель на значение перечисления SLDATATYPE , указывающее тип данных в буфере ppbValue .

Значение	Значение
SL_DATA_SZ	Строка ЮНИКОДа
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Двоичный BLOB-объект
SL_DATA_MULTI_SZ	Массив строк ЮНИКОД с двойным завершением NULL

[out] pcbValue

Тип: UINT*

Указатель на размер буфера ppbValue в байтах.

[out] ppbValue

Тип: PBYTE*

В случае успешного выполнения данные возвращаются в буфер, выделенный SLC.
Завершив использование памяти, освободите ее, вызвав функцию LocalFree .

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

Тип: HRESULT WINAPI

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Возвращаемый код или значение	Описание
E_INVALIDARG 0x80070057	Один или несколько аргументов недопустимы.
SL_E_VALUE_NOT_FOUND 0xC004F012	Значение входного ключа не найдено.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	slpublic.h
Библиотека	Slc.lib
DLL	Slc.dll