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設定すると、コンピューターは非固有の猶予期間モードになります。 |
[in] eDataType
pbValue バッファー内のデータの種類を指定する SLDATATYPE 列挙の値へのポインター。
[in, optional] cbValue
pbValue バッファーのサイズ (バイト単位) へのポインター。
[in, optional] pbValue
pwszValueName パラメーターで指定された名前に関連付けられた値を指定する BYTE 値の配列へのポインター。
一部の名前と値のペアでは、このパラメーターを NULL にすることができます。 この場合、名前と値のペアの既存の値が削除されます。
この配列の使用が完了したら、 LocalFree 関数を呼び出して解放します。
戻り値
メソッドが成功すると、 S_OKが返されます。
メソッドが失敗すると、エラー コードが返されます。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
この関数は、Winerror.h および Slerror.h で定義されている次の値を返すことができます。
リターン コード/値 | Description |
---|---|
|
呼び出し元には管理特権がありません。 |
|
pbValue パラメーターを NULL にすることはできません。 |
|
pbValue バッファーが小さすぎてデータを保持できません。 |
|
pbValue パラメーターのデータ型が、eDataType パラメーターで指定された型と一致しません。 |
|
指定された名前と値のペアは、設定されていない名前と値のペアによって異なります。 |
|
pwszValueName パラメーターで指定された名前はサポートされていません。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | slpublic.h |
Library | Slc.lib |
[DLL] | Slc.dll |