Funzione SLGetServiceInformation (slpublic.h)

  • Articolo

Ottiene informazioni sui dati globali.

Sintassi

HRESULT SLGetServiceInformation(
  [in]            HSLC       hSLC,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Parametri

[in] hSLC

Tipo: HSLC

Handle per il contesto SLC corrente.

[in] pwszValueName

Tipo: PCWSTR

Nome associato al valore da recuperare. I nomi seguenti sono validi.

Valore Significato
SL_INFO_KEY_VERSION
L"Version"
 Versione del servizio SL. ad esempio "1.2.3.4"
SL_INFO_KEY_SYSTEM_STATE
L"SystemState"
 Stato del sistema
SL_INFO_KEY_ACTIVE_PLUGINS
L"ActivePlugins"
 Percorsi DLL completi per tutti i plug-in attivi (null delimitato e con terminazione NULL doppia)
SL_INFO_KEY_SECURE_STORE_ID
L"SecureStoreId"
 ID archivio sicuro (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID
L"SessionMachineId"
 ID computer sessione (BLOB binario)

[out, optional] peDataType

Tipo: SLDATATYPE*

Puntatore a un valore dell'enumerazione SLDATATYPE che specifica il tipo di dati nel buffer ppbValue .

Valore Significato
SL_DATA_SZ
 Stringa UNICODE
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 BLOB binario
SL_DATA_MULTI_SZ
 Matrice di stringhe UNICODE con terminazione Null doppia

[out] pcbValue

Tipo: UINT*

Puntatore alla dimensione, in byte, del buffer ppbValue .

[out] ppbValue

Tipo: PBYTE*

In caso di esito positivo, i dati vengono restituiti nel buffer allocato da SLC.
Al termine dell'uso della memoria, liberarlo chiamando la funzione LocalFree .

Valore restituito

Tipo: HRESULT WINAPI

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Codice/valore restituito Descrizione
E_INVALIDARG
0x80070057
 Uno o più argomenti non sono validi.
SL_E_VALUE_NOT_FOUND
0xC004F012
 Il valore per la chiave di input non è stato trovato.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione slpublic.h
Libreria Slc.lib
DLL Slc.dll