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 |
|---|---|
|
Get a value that specifies whether the computer is genuine. |
|
Get a value that specifies whether the computer is in nongenuine grace period mode. |
|
Get the value returned from the last call to the SLAcquireGenuineTicket function. |
|
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 |
|---|---|
|
The name specified by the pwszValueName parameter is not supported. |
|
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 |