Função SLGetPKeyInformation (slpublic.h)

Artigo
03/02/2024

Obtém as informações da chave do produto (Product Key) especificada.

Sintaxe

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

Parâmetros

[in] hSLC

Tipo: HSLC

O identificador para o contexto SLC atual.

[in] pPKeyId

Tipo: const SLID*

Um ponteiro para a ID PKey.

[in] pwszValueName

Tipo: PCWSTR

O nome associado ao valor a ser recuperado. Os nomes a seguir são válidos.

Valor	Significado
SL_INFO_KEY_DIGITAL_PID L"DigitalPID"	Estrutura pid formatada para um PID4
SL_INFO_KEY_DIGITAL_PID2 L"DigitalPID2"	Estrutura de PID formatada para um PID2
SL_INFO_KEY_PARTIAL_PRODUCT_KEY L"PartialProductKey"	Primeiros 5 caracteres da chave do produto (Product Key)
SL_INFO_KEY_PRODUCT_SKU_ID L"ProductSkuId"	SKU SLID
SL_INFO_KEY_CHANNEL L"Channel"	ID do Canal

[out, optional] peDataType

Tipo: SLDATATYPE*

O tipo de dados.

Valor	Significado
SL_DATA_SZ	Cadeia de caracteres UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	BLOB binário

[out] pcbValue

Tipo: UINT*

Um ponteiro para o tamanho, em bytes, do buffer ppbValue .

[out] ppbValue

Tipo: PBYTE*

Um ponteiro para os dados retornados pelo SLC.
Quando terminar de usar a memória, libere-a chamando a função LocalFree .

Retornar valor

Tipo: HRESULT WINAPI

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Valor/código retornado	Descrição
E_INVALIDARG 0x80070057	Um ou mais argumentos não são válidos.
SL_E_PKEY_NOT_INSTALLED 0xC004F014	A chave do produto (Product Key) não está disponível.
SL_E_NOT_SUPPORTED 0xC004F016	A solicitação não terá suporte.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	slpublic.h
Biblioteca	Slc.lib
DLL	Slc.dll