Funzione SLGetPKeyInformation (slpublic.h)

Ottiene le informazioni del codice Product Key specificato.

Sintassi

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

Parametri

[in] hSLC

Tipo: HSLC

Handle per il contesto SLC corrente.

[in] pPKeyId

Tipo: const SLID*

Puntatore all'ID PKey.

[in] pwszValueName

Tipo: PCWSTR

Nome associato al valore da recuperare. I nomi seguenti sono validi.

Valore	Significato
SL_INFO_KEY_DIGITAL_PID L"DigitalPID"	Struttura PID formattata per un PID4
SL_INFO_KEY_DIGITAL_PID2 L"DigitalPID2"	Struttura PID formattata per un PID2
SL_INFO_KEY_PARTIAL_PRODUCT_KEY L"PartialProductKey"	Primi 5 caratteri del codice Product Key
SL_INFO_KEY_PRODUCT_SKU_ID L"ProductSkuId"	SKU SLID
SL_INFO_KEY_CHANNEL L"Channel"	ID canale

[out, optional] peDataType

Tipo: SLDATATYPE*

Tipo di dati.

Valore	Significato
SL_DATA_SZ	Stringa UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	BLOB binario

[out] pcbValue

Tipo: UINT*

Puntatore alla dimensione, in byte, del buffer ppbValue .

[out] ppbValue

Tipo: PBYTE*

Puntatore ai dati restituiti da SLC.
Al termine dell'uso della memoria, liberarlo chiamando la funzione LocalFree .

Valore restituito

Tipo: HRESULT WINAPI

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Codice/valore restituito	Descrizione
E_INVALIDARG 0x80070057	Uno o più argomenti non sono validi.
SL_E_PKEY_NOT_INSTALLED 0xC004F014	Il codice Product Key non è disponibile.
SL_E_NOT_SUPPORTED 0xC004F016	La richiesta non è supportata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	slpublic.h
Libreria	Slc.lib
DLL	Slc.dll