Fonction SLGetPKeyInformation (slpublic.h)

Article
03/02/2024

Obtient les informations de la clé de produit spécifiée.

Syntaxe

HRESULT SLGetPKeyInformation(
  [in]            HSLC       hSLC,
  [in]            const SLID *pPKeyId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Paramètres

[in] hSLC

Type : HSLC

Handle du contexte SLC actuel.

[in] pPKeyId

Type : const SLID*

Pointeur vers l’ID PKey.

[in] pwszValueName

Type : PCWSTR

Nom associé à la valeur à récupérer. Les noms suivants sont valides.

Valeur	Signification
SL_INFO_KEY_DIGITAL_PID L"DigitalPID »	Structure PID mise en forme pour un PID4
SL_INFO_KEY_DIGITAL_PID2 L"DigitalPID2 »	Structure PID mise en forme pour un PID2
SL_INFO_KEY_PARTIAL_PRODUCT_KEY L"PartialProductKey »	5 premiers caractères de la clé de produit
SL_INFO_KEY_PRODUCT_SKU_ID L"ProductSkuId »	SKU SLID
SL_INFO_KEY_CHANNEL L"Channel »	ID de canal

[out, optional] peDataType

Type : SLDATATYPE*

Type de données.

Valeur	Signification
SL_DATA_SZ	Chaîne UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Blob binaire

[out] pcbValue

Type : UINT*

Pointeur vers la taille, en octets, de la mémoire tampon ppbValue .

[out] ppbValue

Type : PBYTE*

Pointeur vers les données retournées par SLC.
Lorsque vous avez terminé d’utiliser la mémoire, libérez-la en appelant la fonction LocalFree .

Valeur retournée

Type : HRESULT WINAPI

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Code/valeur de retour	Description
E_INVALIDARG 0x80070057	Un ou plusieurs arguments ne sont pas valides.
SL_E_PKEY_NOT_INSTALLED 0xC004F014	La clé de produit n’est pas disponible.
SL_E_NOT_SUPPORTED 0xC004F016	La demande n'est pas prise en charge.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	slpublic.h
Bibliothèque	Slc.lib
DLL	Slc.dll

Partager via