Partager via

SlGetServiceInformation, fonction (slpublic.h)

  • Article

Obtient des informations de données globales.

Syntaxe

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

Paramètres

[in] hSLC

Type : HSLC

Handle du contexte SLC actuel.

[in] pwszValueName

Type : PCWSTR

Nom associé à la valeur à récupérer. Les noms suivants sont valides.

Valeur Signification
SL_INFO_KEY_VERSION
L"Version »
 Version du service SL. Par exemple, « 1.2.3.4 »
SL_INFO_KEY_SYSTEM_STATE
L"SystemState »
 État du système
SL_INFO_KEY_ACTIVE_PLUGINS
L"ActivePlugins »
 Chemins d’accès DLL complets pour tous les plug-ins actifs (délimités par NULL et arrêtés à deux valeurs NULL)
SL_INFO_KEY_SECURE_STORE_ID
L"SecureStoreId »
 ID de magasin sécurisé (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID
L"SessionMachineId »
 ID de l’ordinateur de session (blob binaire)

[out, optional] peDataType

Type : SLDATATYPE*

Pointeur vers une valeur de l’énumération SLDATATYPE qui spécifie le type de données dans la mémoire tampon ppbValue .

Valeur Signification
SL_DATA_SZ
 Chaîne UNICODE
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 Objet blob binaire
SL_DATA_MULTI_SZ
 Tableau de chaînes UNICODE se terminant par deux valeurs Null

[out] pcbValue

Type : UINT*

Pointeur vers la taille, en octets, de la mémoire tampon ppbValue .

[out] ppbValue

Type : PBYTE*

En cas de réussite, les données sont retournées dans la mémoire tampon allouée par SLC.
Lorsque vous avez terminé d’utiliser la mémoire, libérez-la en appelant la fonction LocalFree .

Valeur retournée

Type : HRESULT WINAPI

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Code/valeur de retour Description
E_INVALIDARG
0x80070057
 Un ou plusieurs arguments ne sont pas valides.
SL_E_VALUE_NOT_FOUND
0xC004F012
 La valeur de la clé d’entrée est introuvable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête slpublic.h
Bibliothèque Slc.lib
DLL Slc.dll