SLGetSLIDList function (slpublic.h)

Article
10/13/2021

Gets a list of SLIDs according to the input query ID type and the ID value.

Syntax

HRESULT SLGetSLIDList(
  [in]           HSLC       hSLC,
  [in]           SLIDTYPE   eQueryIdType,
  [in, optional] const SLID *pQueryId,
  [in]           SLIDTYPE   eReturnIdType,
  [out]          UINT       *pnReturnIds,
  [out]          SLID       **ppReturnIds
);

Parameters

[in] hSLC

Type: HSLC

The handle to the current SLC context.

[in] eQueryIdType

Type: SLIDTYPE

The type of input ID.

[in, optional] pQueryId

Type: const SLID*

A pointer to the input ID.

[in] eReturnIdType

Type: SLIDTYPE

The type of returned IDs.

[out] pnReturnIds

Type: UINT*

A pointer to the number of returned IDs.

[out] ppReturnIds

Type: SLID**

An array of returned IDs.

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.
SL_E_NOT_SUPPORT 0xC004F016	The request is not supported.

Remarks

The following queries combinations are supported.

eQueryIdType	pQueryId	eReturnIdType	Results
SL_ID_APPLICATION	SLID_ALL	SL_ID_APPLICATION	Get all installed application IDs.
SL_ID_PRODUCT_SKU	SLID_ALL	SL_ID_PRODUCT_SKU	Get all installed product SKU IDs.
SL_ID_APPLICATION	appId	SL_ID_PRODUCT_SKU	Get SKU IDs according to the input application ID.
SL_ID_PRODUCT_SKU	skuId	SL_ID_APPLICATION	Get application IDs according to the input SKU ID.
SL_ID_PRODUCT_SKU	skuId	SL_ID_PKEY	Get license PKey IDs according to the input SKU ID.
SL_ID_PRODUCT_SKU	skuId	SL_ID_LICENSE_FILE	Get license file Ids according to the input SKU ID.
SL_ID_LICENSE_FILE	fileId	SL_ID_LICENSE	Get license IDs according to the input license file ID.
SL_ID_LICENSE	LicenseId	SL_ID_LICENSE_FILE	Get license file ID according to the input license ID.
SL_ID_LICENSE	LicenseId	SL_ID_APPLICATION	Get union of all application IDs or SKU IDs from all grants of a token activation license. Returns SL_E_NOT_SUPPORTED if the license ID is valid but doesn't refer to a token activation license.
SL_ID_LICENSE	LicenseId	SL_ID_PRODUCT_SKU	Get union of all application IDs or SKU IDs from all grants of a token activation license. Returns SL_E_NOT_SUPPORTED if the license ID is valid but doesn't refer to a token activation license.

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

Share via