Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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:
© 2015 Microsoft