Partager via

Fonction SLGetPKeyInformation (slpublic.h)

  • Article

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