Edit

Share via

SLInstallProofOfPurchase function (slpublic.h)

Registers the product key with SL.

Syntax

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

Parameters

[in] hSLC

Type: HSLC

The handle to the current SLC context.

[in] pwszPKeyAlgorithm

Type: PCWSTR

The product key algorithm.

[in] pwszPKeyString

Type: PCWSTR

The product key string.

[in] cbPKeySpecificData

Type: UINT

The size, in bytes, of product key specific data. If there is no PKey specific data, set cbPKeySpecificData to 0.

[in, optional] pbPKeySpecificData

Type: PBYTE

A pointer to the product key specific data. If there is no PKey specific data, set pbPKeySpecificData to NULL.

[out] pPkeyId

Type: SLID*

A pointer to an identifier of the registered product key. This SLID can be used to reference PKey information later.

Return value

Type: HRESULT WINAPI

If this function succeeds, it return S_OK. Otherwise, it returns an HRESULT error code.

Return code/value Description
E_INVALIDARG
0x80070057
 One or more arguments are not valid.
E_ACCESSDENIED
0x80070005
 Access denied (API requires admin privileges).
SL_E_LUA_ACCESSDENIED
0xC004F025
 The action requires administrator privilege.
SL_E_INVALID_PKEY
0xC004F010
 The product key is not valid.
SL_E_PRODUCT_SKU_NOT_INSTALLED
0xC004F015
 The license is not installed.
SL_E_PKEY_INVALID_UPGRADE
0xC004F061
 This specified product key can only be used for upgrading, not for clean installations.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header slpublic.h
Library Slc.lib
DLL Slc.dll