Funzione SLGetApplicationInformation (slpublic.h)

Ottiene informazioni sull'applicazione specificata.

Sintassi

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

Parametri

[in] hSLC

Tipo: HSLC

Handle per il contesto SLC corrente.

[in] pApplicationId

Tipo: const SLID*

Puntatore all'ID applicazione.

[in] pwszValueName

Tipo: PCWSTR

Valore	Significato
SL_INFO_KEY_IS_KMS L"IsKeyManagementService"	Indica se il computer dispone di un servizio di gestione delle chiavi (KMS) abilitato.
SL_INFO_KEY_KMS_CURRENT_COUNT L"KeyManagementServiceCurrentCount"	Numero di client del volume in un host del Servizio di gestione delle chiavi attualmente attivo.
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT L"KeyManagementServiceRequiredClientCount"	Numero minimo di client VL necessari per connettersi a un host del Servizio di gestione delle chiavi per abilitare l'attivazione.
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS L"KeyManagementServiceUnlicensedRequests"	Numero di richieste del Servizio di gestione delle chiavi da client VL con stato licenza=senza licenza.
SL_INFO_KEY_KMS_LICENSED_REQUESTS L"KeyManagementServiceLicensedRequests"	Numero di richieste del Servizio di gestione delle chiavi da client VL con stato di licenza=concesso in licenza.
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS L"KeyManagementServiceOOBGraceRequests"	Numero di richieste del Servizio di gestione delle chiavi da client VL con Stato licenza=OOB Grace.
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS L"KeyManagementServiceOOTGraceRequests"	Numero di richieste del Servizio di gestione delle chiavi da client VL con Stato licenza=OOT Grace.
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS L"KeyManagementServiceNonGenuineGraceRequests"	Numero di richieste del Servizio di gestione delle chiavi da client VL con stato di licenza=Grace non autentico.
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS L"KeyManagementServiceNotificationRequests"	Numero di richieste del Servizio di gestione delle chiavi dai client VL con License Status=Notification.
SL_INFO_KEY_KMS_TOTAL_REQUESTS L"KeyManagementServiceTotalRequests"	Numero totale di richieste del Servizio di gestione delle chiavi valide.
SL_INFO_KEY_KMS_FAILED_REQUESTS L"KeyManagementServiceFailedRequests"	Numero totale di richieste del Servizio di gestione delle chiavi non riuscite.

[out, optional] peDataType

Tipo: SLDATATYPE*

Puntatore a un valore dell'enumerazione SLDATATYPE che specifica il tipo di dati nel buffer ppbValue. I valori seguenti sono validi.

Valore	Significato
SL_DATA_SZ	Stringa UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	BLOB binario

[out] pcbValue

Tipo: UINT*

Puntatore alla dimensione, in byte, del buffer ppbValue .

[out] ppbValue

Tipo: PBYTE*

In caso di esito positivo, i dati vengono restituiti nel buffer allocato dal SLC.
Al termine dell'uso della memoria, liberarlo chiamando la funzione LocalFree .

Valore restituito

Tipo: HRESULT WINAPI

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Codice/valore restituito	Descrizione
E_INVALIDARG 0x80070057	Uno o più argomenti non sono validi.
SL_E_VALUE_NOT_FOUND 0xC004F012	Il valore per la chiave di input non è stato trovato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	slpublic.h
Libreria	Slc.lib
DLL	Slc.dll