SLGetApplicationInformation function (slpublic.h)

Gets information about the specified application.

Syntax

HRESULT SLGetApplicationInformation(
  [in]            HSLC       hSLC,
  [in]            const SLID *pApplicationId,
  [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] pApplicationId

Type: const SLID*

A pointer to the application ID.

[in] pwszValueName

Type: PCWSTR

Value Meaning
SL_INFO_KEY_IS_KMS
L"IsKeyManagementService"
Indicates whether the machine has a Key Management Service (KMS) enabled.
SL_INFO_KEY_KMS_CURRENT_COUNT
L"KeyManagementServiceCurrentCount"
The number of volume clients on a KMS host that are currently active.
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT
L"KeyManagementServiceRequiredClientCount"
The minimum number of VL clients required to connect to a KMS host for enabling activation.
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS
L"KeyManagementServiceUnlicensedRequests"
The number of KMS requests from VL clients with License Status=Unlicensed.
SL_INFO_KEY_KMS_LICENSED_REQUESTS
L"KeyManagementServiceLicensedRequests"
The number of KMS requests from VL clients with License Status=Licensed.
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS
L"KeyManagementServiceOOBGraceRequests"
The number of KMS requests from VL clients with License Status=OOB Grace.
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS
L"KeyManagementServiceOOTGraceRequests"
The number of KMS requests from VL clients with License Status=OOT Grace.
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS
L"KeyManagementServiceNonGenuineGraceRequests"
The number of KMS requests from VL clients with License Status=Non-Genuine Grace.
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS
L"KeyManagementServiceNotificationRequests"
The number of KMS requests from VL clients with License Status=Notification.
SL_INFO_KEY_KMS_TOTAL_REQUESTS
L"KeyManagementServiceTotalRequests"
Total number of valid KMS requests.
SL_INFO_KEY_KMS_FAILED_REQUESTS
L"KeyManagementServiceFailedRequests"
Total number of failed KMS requests.

[out, optional] peDataType

Type: SLDATATYPE*

A pointer to a value of the SLDATATYPE enumeration that specifies the type of data in the ppbValue buffer. The following values are valid.

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 the 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