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