共用方式為

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 會將電腦置於非genuine 寬限期模式中。

[in] eDataType

指定 pbValue 緩衝區中數據類型之 SLDATATYPE 列舉值的指標。

[in, optional] cbValue

pbValue 緩衝區的大小指標，以位元組為單位。

[in, optional] pbValue

BYTE 值的陣列指標，指定與 pwszValueName 參數所指定之名稱相關聯的值。

某些名稱/值組允許此參數為 NULL。 在此情況下，會刪除名稱/值組的現有值。

當您完成使用此陣列時，請呼叫 LocalFree 函式來釋放它。

傳回值

如果方法成功，它會 傳回S_OK。

如果方法失敗，則會傳回錯誤碼。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

此函式可以傳回 Winerror.h 和 Slerror.h 中定義的下列值。

傳回碼/值 Description
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
標頭 slpublic.h
程式庫 Slc.lib
Dll Slc.dll