Freigeben über

SLGetServiceInformation-Funktion (slpublic.h)

  • Artikel

Ruft globale Dateninformationen ab.

Syntax

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

Parameter

[in] hSLC

Typ: HSLC

Das Handle für den aktuellen SLC-Kontext.

[in] pwszValueName

Typ: PCWSTR

Der dem abzurufenden Wert zugeordnete Name. Die folgenden Namen sind gültig.

Wert Bedeutung
SL_INFO_KEY_VERSION
L"Version"
 Version des SL-Diensts. z. B. "1.2.3.4"
SL_INFO_KEY_SYSTEM_STATE
L"SystemState"
 Systemstatus
SL_INFO_KEY_ACTIVE_PLUGINS
L"ActivePlugins"
 Vollqualifizierte DLL-Pfade für alle aktiven Plug-Ins (NULL-Trennzeichen und doppelte NULL-Beendigung)
SL_INFO_KEY_SECURE_STORE_ID
L"SecureStoreId"
 ID des sicheren Speichers (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID
L"SessionMachineId"
 Sitzungscomputer-ID (Binäres BLOB)

[out, optional] peDataType

Typ: SLDATATYPE*

Ein Zeiger auf einen Wert der SLDATATYPE-Enumeration , der den Datentyp im ppbValue-Puffer angibt.

Wert Bedeutung
SL_DATA_SZ
 UNICODE-Zeichenfolge
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 Binäres Blob
SL_DATA_MULTI_SZ
 Doppeltes UNICODE-Zeichenfolgenarray mit Null-Beendigung

[out] pcbValue

Typ: UINT*

Ein Zeiger auf die Größe des ppbValue-Puffers in Bytes.

[out] ppbValue

Typ: PBYTE*

Bei erfolgreicher Ausführung werden die Daten im Puffer zurückgegeben, der von SLC zugewiesen wird.
Wenn Sie mit der Verwendung des Arbeitsspeichers fertig sind, geben Sie ihn frei, indem Sie die LocalFree-Funktion aufrufen.

Rückgabewert

Typ: HRESULT WINAPI

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Rückgabecode/-wert BESCHREIBUNG
E_INVALIDARG
0x80070057
 Mindestens ein Argument ist ungültig.
SL_E_VALUE_NOT_FOUND
0xC004F012
 Der Wert für den Eingabeschlüssel wurde nicht gefunden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile slpublic.h
Bibliothek Slc.lib
DLL Slc.dll