共用方式為

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”
 安全存放區標識碼 (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID
L“SessionMachineId”
 會話機器標識碼 (二進位 BLOB)

[out, optional] peDataType

類型： SLDATATYPE*

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

值 意義
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
 一或多個自變數無效。
SL_E_VALUE_NOT_FOUND
0xC004F012
 找不到輸入索引鍵的值。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 slpublic.h
程式庫 Slc.lib
Dll Slc.dll