Поделиться через

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

  • Статья

Указывает сведения о подлинном состоянии компьютера Windows.

Синтаксис

HRESULT SLSetGenuineInformation(
  [in]           const SLID *pQueryId,
  [in]           PCWSTR     pwszValueName,
  [in]           SLDATATYPE eDataType,
  [in, optional] UINT       cbValue,
  [in, optional] const BYTE *pbValue
);

Параметры

[in] pQueryId

Указатель на структуру SLID , указывающую приложение, для которого нужно задать сведения.

[in] pwszValueName

Указатель на строку, завершающуюся значением NULL, которая содержит имя, связанное со значением для задания. Допустимы следующие имена.

Значение Значение
SL_BRT_DATA
 Задайте сведения о подлинном состоянии компьютера.
SL_BRT_COMMIT
 Если задано значение SL_BRT_DATA , установка SL_BRT_COMMIT переводит компьютер в необщинный режим льготного периода.

[in] eDataType

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

[in, optional] cbValue

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

[in, optional] pbValue

Указатель на массив значений BYTE , указывающий значение, связанное с именем, заданным параметром pwszValueName .

Некоторые пары "имя-значение" позволяют этому параметру иметь значение NULL. В этом случае удаляется существующее значение пары "имя-значение".

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

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

Если метод завершается успешно, он возвращает S_OK.

Если происходит сбой метода, он возвращает код ошибки. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Эта функция может возвращать следующие значения, определенные в файлах Winerror.h и Slerror.h.

Возвращаемый код или значение Описание
E_ACCESS_DENIED
0x80070005
 Вызывающий объект не имеет прав администратора.
E_INVALIDARG
0x80000003
 Параметр pbValue не может иметь значение NULL.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW
0x111
 Буфер pbValue слишком мал для хранения данных.
SL_E_DATATYPE_MISMATCHED
0xC004F01E
 Тип данных параметра pbValue не соответствует типу, указанному параметром eDataType .
SL_E_DEPENDENT_PROPERTY_NOT_SET
0xC004F066
 Указанная пара "имя-значение" зависит от пары "имя-значение", которая не была задана.
SL_E_NOT_SUPPORTED
0xC004F016
 Имя, указанное параметром pwszValueName , не поддерживается.

Требования

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