SLGetGenuineInformation function (slpublic.h)

Gets information about the genuine state of a Windows computer.

Syntax

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

Parameters

[in] pQueryId

A pointer to an SLID structure that specifies the application to check.

[in] pwszValueName

A pointer to a null-terminated string that contains the name associated with the value to retrieve. The following names are valid.

Value	Meaning
SL_BRT_DATA	Get a value that specifies whether the computer is genuine.
SL_BRT_COMMIT	Get a value that specifies whether the computer is in nongenuine grace period mode.
SL_GENUINE_RESULT	Get the value returned from the last call to the SLAcquireGenuineTicket function.
SL_NONGENUINE_GRACE_FLAG	Gets the cause of the computer being put into nongenuine grace period mode.

[out, optional] peDataType

A pointer to a value of the SLDATATYPE enumeration that specifies the type of data in the ppbValue buffer.

[out] pcbValue

A pointer to the size, in bytes, of the ppbValue buffer.

[out] ppbValue

The address of a pointer to an array of BYTE pointers that specifies the value associated with the name specified by the pwszValueName parameter.

When you have finished using this array, free it by calling the LocalFree function.

Return value

If the method succeeds, it returns S_OK.

If the method fails, it returns an error code. For a list of common error codes, see Common HRESULT Values.

This function can return the following values defined in Slerror.h.

Return code/value	Description
SL_E_NOT_SUPPORTED 0xC004F016	The name specified by the pwszValueName parameter is not supported.
SL_E_VALUE_NOT_FOUND 0xC004F012	The specified name-value pair was not found.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	slpublic.h
Library	Slc.lib
DLL	Slc.dll

See also

SLDATATYPE

SLGetWindowsInformation