SLGetLicenseInformation-Funktion (slpublic.h)

Ruft die angegebenen Lizenzinformationen ab.

Syntax

HRESULT SLGetLicenseInformation(
  [in]            HSLC       hSLC,
  [in]            const SLID *pSLLicenseId,
  [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] pSLLicenseId

Typ: const SLID*

Ein Zeiger auf die Lizenz-ID.

[in] pwszValueName

Typ: PCWSTR

Der Name, der dem abzurufenden Wert zugeordnet ist. Die folgenden Werte sind gültig.

Wert	Bedeutung
SL_INFO_KEY_DESCRIPTION L"Description"	Die Beschreibung der Lizenz.
SL_INFO_KEY_LICENSE_TYPE L"LicenseType"	Der Typ der Lizenz.
SL_INFO_KEY_VERSION L"Version"	Die Version der Lizenz.

[out, optional] peDataType

Typ: SLDATATYPE*

Ein Zeiger auf einen Wert der SLDATATYPE-Enumeration , der den Datentyp im ppbValue-Puffer angibt. Zulässige Werte sind:

Wert	Bedeutung
SL_DATA_SZ	UNICODE-Zeichenfolge
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Binäres BLOB

[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 in dem puffer zurückgegeben, der von SLC zugeordnet ist.
Wenn Sie mit der Verwendung des Arbeitsspeichers fertig sind, geben Sie ihn frei, indem Sie die Funktion LocalFree 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