Freigeben über

SLInstallProofOfPurchase-Funktion (slpublic.h)

  • Artikel

Registriert den Product Key bei SL.

Syntax

HRESULT SLInstallProofOfPurchase(
  [in]           HSLC   hSLC,
  [in]           PCWSTR pwszPKeyAlgorithm,
  [in]           PCWSTR pwszPKeyString,
  [in]           UINT   cbPKeySpecificData,
  [in, optional] PBYTE  pbPKeySpecificData,
  [out]          SLID   *pPkeyId
);

Parameter

[in] hSLC

Typ: HSLC

Das Handle für den aktuellen SLC-Kontext.

[in] pwszPKeyAlgorithm

Typ: PCWSTR

Der Product Key-Algorithmus.

[in] pwszPKeyString

Typ: PCWSTR

Die Product Key-Zeichenfolge.

[in] cbPKeySpecificData

Typ: UINT

Die Größe der product key-spezifischen Daten in Bytes. Wenn keine PKey-spezifischen Daten vorhanden sind, legen Sie cbPKeySpecificData auf 0 fest.

[in, optional] pbPKeySpecificData

Typ: PBYTE

Ein Zeiger auf die product key-spezifischen Daten. Wenn keine PKey-spezifischen Daten vorhanden sind, legen Sie pbPKeySpecificData auf NULL fest.

[out] pPkeyId

Typ: SLID*

Ein Zeiger auf einen Bezeichner des registrierten Product Keys. Dieser SLID kann später verwendet werden, um auf PKey-Informationen zu verweisen.

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.
E_ACCESSDENIED
0x80070005
 Zugriff verweigert (FÜR die API sind Administratorrechte erforderlich).
SL_E_LUA_ACCESSDENIED
0xC004F025
 Die Aktion erfordert Administratorrechte.
SL_E_INVALID_PKEY
0xC004F010
 Der Product Key ist ungültig.
SL_E_PRODUCT_SKU_NOT_INSTALLED
0xC004F015
 Die Lizenz ist nicht installiert.
SL_E_PKEY_INVALID_UPGRADE
0xC004F061
 Dieser angegebene Product Key kann nur für Upgrades und nicht für sauber Installationen verwendet werden.

Anforderungen

   
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