Compartir a través de


Función SLSetGenuineInformation (slpublic.h)

Especifica información sobre el estado genuino de un equipo Windows.

Sintaxis

HRESULT SLSetGenuineInformation(
  [in]           const SLID *pQueryId,
  [in]           PCWSTR     pwszValueName,
  [in]           SLDATATYPE eDataType,
  [in, optional] UINT       cbValue,
  [in, optional] const BYTE *pbValue
);

Parámetros

[in] pQueryId

Puntero a una estructura SLID que especifica la aplicación para la que se va a establecer información.

[in] pwszValueName

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

Valor Significado
SL_BRT_DATA
Establezca información sobre el estado genuino del equipo.
SL_BRT_COMMIT
Si se establece el valor de SL_BRT_DATA , al establecer SL_BRT_COMMIT se coloca el equipo en modo de período de gracia no degenuina.

[in] eDataType

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

[in, optional] cbValue

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

[in, optional] pbValue

Puntero a una matriz de valores BYTE que especifican el valor asociado al nombre especificado por el parámetro pwszValueName .

Algunos pares nombre-valor permiten que este parámetro sea NULL. En este caso, se elimina el valor existente del par nombre-valor.

Cuando haya terminado de usar esta matriz, ábrela 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 Winerror.h y Slerror.h.

Código o valor devuelto Descripción
E_ACCESS_DENIED
0x80070005
El autor de la llamada no tiene privilegios administrativos.
E_INVALIDARG
0x80000003
El parámetro pbValue no puede ser NULL.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW
0x111
El búfer pbValue es demasiado pequeño para contener los datos.
SL_E_DATATYPE_MISMATCHED
0xC004F01E
El tipo de datos del parámetro pbValue no coincide con el tipo especificado por el parámetro eDataType .
SL_E_DEPENDENT_PROPERTY_NOT_SET
0xC004F066
El par nombre-valor especificado depende de un par nombre-valor que no se haya establecido.
SL_E_NOT_SUPPORTED
0xC004F016
No se admite el nombre especificado por el parámetro pwszValueName .

Requisitos

Requisito Value
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