Función SLGetGenuineInformation (slpublic.h)

  • Artículo

Obtiene información sobre el estado original de un equipo Windows.

Sintaxis

HRESULT SLGetGenuineInformation(
  [in]            const SLID *pQueryId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           BYTE       **ppbValue
);

Parámetros

[in] pQueryId

Puntero a una estructura SLID que especifica la aplicación que se va a comprobar.

[in] pwszValueName

Puntero a una cadena terminada en null que contiene el nombre asociado al valor que se va a recuperar. Los nombres siguientes son válidos.

Valor Significado
SL_BRT_DATA
 Obtiene un valor que especifica si el equipo es original.
SL_BRT_COMMIT
 Obtiene un valor que especifica si el equipo está en modo de período de gracia no genérico.
SL_GENUINE_RESULT
 Obtenga el valor devuelto desde la última llamada a la función SLAcquireGenuineTicket .
SL_NONGENUINE_GRACE_FLAG
 Obtiene la causa de que el equipo se ponga en modo de período de gracia no genérico.

[out, optional] peDataType

Puntero a un valor de la enumeración SLDATATYPE que especifica el tipo de datos en el búfer ppbValue .

[out] pcbValue

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

[out] ppbValue

Dirección de un puntero a una matriz de punteros BYTE que especifica el valor asociado al nombre especificado por el parámetro pwszValueName .

Cuando haya terminado de usar esta matriz, puede liberarla llamando a la función LocalFree .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Si el método genera un error, este método devuelve un código de error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Esta función puede devolver los siguientes valores definidos en Slerror.h.

Código o valor devuelto Descripción
SL_E_NOT_SUPPORTED
0xC004F016
 No se admite el nombre especificado por el parámetro pwszValueName .
SL_E_VALUE_NOT_FOUND
0xC004F012
 No se encontró el par nombre-valor especificado.

Requisitos

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

Consulte también

SLDATATYPE

SLGetWindowsInformation