Compartir a través de

Función SLGetPKeyInformation (slpublic.h)

  • Artículo

Obtiene la información de la clave de producto especificada.

Sintaxis

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

Identificador del contexto SLC actual.

[in] pPKeyId

Tipo: const SLID*

Puntero al identificador de clave PKey.

[in] pwszValueName

Tipo: PCWSTR

Nombre asociado con el valor que se va a recuperar. Los nombres siguientes son válidos.

Valor Significado
SL_INFO_KEY_DIGITAL_PID
L"DigitalPID"
 Estructura PID con formato para un PID4
SL_INFO_KEY_DIGITAL_PID2
L"DigitalPID2"
 Estructura PID con formato para un PID2
SL_INFO_KEY_PARTIAL_PRODUCT_KEY
L"PartialProductKey"
 Primeros 5 caracteres de clave de producto
SL_INFO_KEY_PRODUCT_SKU_ID
L"ProductSkuId"
 SKU SLID
SL_INFO_KEY_CHANNEL
L"Channel"
 Channel ID

[out, optional] peDataType

Tipo: SLDATATYPE*

Tipo de datos.

Valor Significado
SL_DATA_SZ
 Cadena UNICODE
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 BLOB binario

[out] pcbValue

Tipo: UINT*

Puntero al tamaño, en bytes, del búfer ppbValue .

[out] ppbValue

Tipo: PBYTE*

Puntero a los datos devueltos por SLC.
Cuando termine de usar la memoria, libere la llamada a la función LocalFree .

Valor devuelto

Tipo: HRESULT WINAPI

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Código o valor devuelto Descripción
E_INVALIDARG
0x80070057
 Uno o varios argumentos no son válidos.
SL_E_PKEY_NOT_INSTALLED
0xC004F014
 La clave de producto no está disponible.
SL_E_NOT_SUPPORTED
0xC004F016
 No se admite la solicitud.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado slpublic.h
Library Slc.lib
Archivo DLL Slc.dll