nf-slpublic-slgetpkeyinformation.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:slpublic.SLGetPKeyInformation	SLGetPKeyInformation function (slpublic.h)	Gets the information of the specified product key.	SLGetPKeyInformation SLGetPKeyInformation function [Security] SL_DATA_BINARY SL_DATA_DWORD SL_DATA_SZ SL_INFO_KEY_CHANNEL SL_INFO_KEY_DIGITAL_PID SL_INFO_KEY_DIGITAL_PID2 SL_INFO_KEY_PARTIAL_PRODUCT_KEY SL_INFO_KEY_PRODUCT_SKU_ID security.slgetpkeyinformation slpublic/SLGetPKeyInformation	security\slgetpkeyinformation.htm	security	b7728d20-da39-4443-aaca-a6461880bb53	12/05/2018	SLGetPKeyInformation, SLGetPKeyInformation function [Security], SL_DATA_BINARY, SL_DATA_DWORD, SL_DATA_SZ, SL_INFO_KEY_CHANNEL, SL_INFO_KEY_DIGITAL_PID, SL_INFO_KEY_DIGITAL_PID2, SL_INFO_KEY_PARTIAL_PRODUCT_KEY, SL_INFO_KEY_PRODUCT_SKU_ID, security.slgetpkeyinformation, slpublic/SLGetPKeyInformation	slpublic.h		Windows	Windows 8 [desktop apps only]	Windows Server 2012 [desktop apps only]										Slc.lib	Slc.dll		Windows			19H1	SLGetPKeyInformation slpublic/SLGetPKeyInformation	c++	APIRef kbSyntax	DllExport	Slc.dll	SLGetPKeyInformation

SLGetPKeyInformation function

-description

Gets the information of the specified product key.

-parameters

-param hSLC [in]

Type: HSLC

The handle to the current SLC context.

-param pPKeyId [in]

Type: const SLID*

A pointer to the PKey ID.

-param pwszValueName [in]

Type: PCWSTR

The name associated with the value to retrieve. The following names are valid.

Value	Meaning
SL_INFO_KEY_DIGITAL_PID L"DigitalPID"	Formatted PID structure for a PID4
SL_INFO_KEY_DIGITAL_PID2 L"DigitalPID2"	Formatted PID structure for a PID2
SL_INFO_KEY_PARTIAL_PRODUCT_KEY L"PartialProductKey"	First 5 characters of product key
SL_INFO_KEY_PRODUCT_SKU_ID L"ProductSkuId"	SKU SLID
SL_INFO_KEY_CHANNEL L"Channel"	Channel ID

-param peDataType [out, optional]

Type: SLDATATYPE*

The data type.

Value	Meaning
SL_DATA_SZ	UNICODE string
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Binary BLOB

-param pcbValue [out]

Type: UINT*

A pointer to the size, in bytes, of the ppbValue buffer.

-param ppbValue [out]

Type: PBYTE*

A pointer to the data returned by SLC.
When finished using the memory, free it by calling the LocalFree function.

-returns

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.
SL_E_PKEY_NOT_INSTALLED 0xC004F014	The product key is not available.
SL_E_NOT_SUPPORTED 0xC004F016	The request is not supported.