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"	セキュリティで保護されたストア ID (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID L"SessionMachineId"	セッション マシン ID (バイナリ BLOB)

[out, optional] peDataType

型: SLDATATYPE*

ppbValue バッファー内のデータ型を指定する SLDATATYPE 列挙の値へのポインター。

値	意味
SL_DATA_SZ	UNICODE 文字列
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	バイナリ BLOB
SL_DATA_MULTI_SZ	null で終わる二重 UNICODE 文字列配列

[out] pcbValue

種類: UINT*

ppbValue バッファーのサイズ (バイト単位) へのポインター。

[out] ppbValue

種類: PBYTE*

成功した場合、SLC によって割り当てられたバッファーにデータが返されます。
メモリの使用が完了したら、 LocalFree 関数を呼び出して解放します。

戻り値

種類: HRESULT WINAPI

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

リターン コード/値	Description
E_INVALIDARG 0x80070057	1 つ以上の引数が無効です。
SL_E_VALUE_NOT_FOUND 0xC004F012	入力キーの値が見つかりませんでした。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	slpublic.h
Library	Slc.lib
[DLL]	Slc.dll