Freigeben über

SLGetPKeyInformation-Funktion (slpublic.h)

  • Artikel

Ruft die Informationen des angegebenen Product Keys ab.

Syntax

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

Typ: const SLID*

Ein Zeiger auf die PKey-ID.

[in] pwszValueName

Typ: PCWSTR

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

Wert Bedeutung
SL_INFO_KEY_DIGITAL_PID
L"DigitalPID"
 Formatierte PID-Struktur für eine PID4
SL_INFO_KEY_DIGITAL_PID2
L"DigitalPID2"
 Formatierte PID-Struktur für eine PID2
SL_INFO_KEY_PARTIAL_PRODUCT_KEY
L"PartialProductKey"
 Erste 5 Zeichen des Product Keys
SL_INFO_KEY_PRODUCT_SKU_ID
L"ProductSkuId"
 SKU SLID
SL_INFO_KEY_CHANNEL
L"Kanal"
 Kanal-ID

[out, optional] peDataType

Typ: SLDATATYPE*

Der Datentyp.

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*

Ein Zeiger auf die von SLC zurückgegebenen Daten.
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_PKEY_NOT_INSTALLED
0xC004F014
 Der Product Key ist nicht verfügbar.
SL_E_NOT_SUPPORTED
0xC004F016
 Die Anforderung wird nicht unterstützt.

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