Edit

Share via

SLGetLicenseInformation function (slpublic.h)

  • Article

Gets the specified license information.

Syntax

HRESULT SLGetLicenseInformation(
  [in]            HSLC       hSLC,
  [in]            const SLID *pSLLicenseId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Parameters

[in] hSLC

Type: HSLC

The handle to the current SLC context.

[in] pSLLicenseId

Type: const SLID*

A pointer to the license ID.

[in] pwszValueName

Type: PCWSTR

The name associated with the value to retrieve.. The following values are valid.

Value Meaning
SL_INFO_KEY_DESCRIPTION
L"Description"
 The description of the license.
SL_INFO_KEY_LICENSE_TYPE
L"LicenseType"
 The type of the license.
SL_INFO_KEY_VERSION
L"Version"
 The version of the license.

[out, optional] peDataType

Type: SLDATATYPE*

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

Value Meaning
SL_DATA_SZ
 UNICODE string
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 Binary BLOB

[out] pcbValue

Type: UINT*

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

[out] ppbValue

Type: PBYTE*

If successful, the data is returned in the buffer allocated by SLC.
When finished using the memory, free it by calling the LocalFree function.

Return value

Type: HRESULT WINAPI

If this function succeeds, it return S_OK. Otherwise, it returns an HRESULT error code.

Return code/value Description
E_INVALIDARG
0x80070057
 One or more arguments are not valid.
SL_E_VALUE_NOT_FOUND
0xC004F012
 The value for the input key was not found.

Requirements

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