Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SLGetGenuineInformation

SLGetGenuineInformation function

Gets information about the genuine state of a Windows computer.

Syntax


HRESULT WINAPI SLGetGenuineInformation(
  _In_      const SLID       *pAppId,
  _In_            PCWSTR     pwszValueName,
  _Out_opt_       SLDATATYPE *peDataType,
  _Out_           UINT       *pcbValue,
  _Out_           BYTE       **ppbValue
);

Parameters

pAppId [in]

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

pwszValueName [in]

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

ValueMeaning
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.

 

peDataType [out, optional]

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

pcbValue [out]

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

ppbValue [out]

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/valueDescription
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Slpublic.h

Library

Slc.lib

DLL

Slc.dll

See also

SLDATATYPE
SLGetWindowsInformation

 

 

Community Additions

ADD
Show:
© 2015 Microsoft