SlGetApplicationInformation, fonction (slpublic.h)

Article
03/02/2024

Obtient des informations sur l’application spécifiée.

Syntaxe

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

Paramètres

[in] hSLC

Type : HSLC

Handle du contexte SLC actuel.

[in] pApplicationId

Type : const SLID*

Pointeur vers l’ID d’application.

[in] pwszValueName

Type : PCWSTR

Valeur	Signification
SL_INFO_KEY_IS_KMS L"IsKeyManagementService »	Indique si un service de gestion de clés (KMS) est activé sur l’ordinateur.
SL_INFO_KEY_KMS_CURRENT_COUNT L"KeyManagementServiceCurrentCount »	Nombre de clients de volume sur un hôte KMS actuellement actifs.
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT L"KeyManagementServiceRequiredClientCount »	Nombre minimal de clients VL requis pour se connecter à un hôte KMS pour activer l’activation.
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS L"KeyManagementServiceUnlicensedRequests »	Nombre de requêtes KMS provenant de clients VL avec l’état de la licence =sans licence.
SL_INFO_KEY_KMS_LICENSED_REQUESTS L"KeyManagementServiceLicensedRequests »	Nombre de demandes KMS provenant de clients VL avec License Status=License.
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS L"KeyManagementServiceOOBGraceRequests »	Nombre de requêtes KMS provenant de clients VL avec License Status=OOB Grace.
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS L"KeyManagementServiceOOTGraceRequests »	Nombre de requêtes KMS provenant de clients VL avec License Status=OOT Grace.
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS L"KeyManagementServiceNonGenuineGraceRequests »	Nombre de demandes KMS de clients VL avec License Status=Non-Genuine Grace.
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS L"KeyManagementServiceNotificationRequests »	Nombre de demandes KMS provenant de clients VL avec License Status=Notification.
SL_INFO_KEY_KMS_TOTAL_REQUESTS L"KeyManagementServiceTotalRequests »	Nombre total de requêtes KMS valides.
SL_INFO_KEY_KMS_FAILED_REQUESTS L"KeyManagementServiceFailedRequests »	Nombre total de requêtes KMS ayant échoué.

[out, optional] peDataType

Type : SLDATATYPE*

Pointeur vers une valeur de l’énumération SLDATATYPE qui spécifie le type de données dans la mémoire tampon ppbValue. Les valeurs suivantes sont valides.

Valeur	Signification
SL_DATA_SZ	Chaîne UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Objet blob binaire

[out] pcbValue

Type : UINT*

Pointeur vers la taille, en octets, de la mémoire tampon ppbValue .

[out] ppbValue

Type : PBYTE*

En cas de réussite, les données sont retournées dans la mémoire tampon allouée par le SLC.
Lorsque vous avez terminé d’utiliser la mémoire, libérez-la en appelant la fonction LocalFree .

Valeur retournée

Type : HRESULT WINAPI

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Code/valeur de retour	Description
E_INVALIDARG 0x80070057	Un ou plusieurs arguments ne sont pas valides.
SL_E_VALUE_NOT_FOUND 0xC004F012	La valeur de la clé d’entrée est introuvable.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	slpublic.h
Bibliothèque	Slc.lib
DLL	Slc.dll

Partager via