SLInstallProofOfPurchase function

Registers the product key with SL.

Syntax


HRESULT WINAPI SLInstallProofOfPurchase(
  _In_      HSLC hSLC,
  _In_      PCWSTR pwszPKeyAlgorithm,
  _In_      PCWSTR pwszPKeyString,
  _In_      UINT cbPKeySpecificData,
  _In_opt_  PBYTE pbPKeySpecificData,
  _Out_     SLID *pPKeyId
);

Parameters

hSLC [in]

Type: HSLC

The handle to the current SLC context.

pwszPKeyAlgorithm [in]

Type: PCWSTR

The product key algorithm.

pwszPKeyString [in]

Type: PCWSTR

The product key string.

cbPKeySpecificData [in]

Type: UINT

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

pbPKeySpecificData [in, optional]

Type: PBYTE

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

pPKeyId [out]

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/valueDescription
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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Slpublic.h

Library

Slc.lib

DLL

Slc.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft