SlGetGenuineInformation, fonction (slpublic.h)

Article
08/26/2023

Obtient des informations sur l’état authentique d’un ordinateur Windows.

Syntaxe

HRESULT SLGetGenuineInformation(
  [in]            const SLID *pQueryId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           BYTE       **ppbValue
);

Paramètres

[in] pQueryId

Pointeur vers une structure SLID qui spécifie l’application à case activée.

[in] pwszValueName

Pointeur vers une chaîne terminée par null qui contient le nom associé à la valeur à récupérer. Les noms suivants sont valides.

Valeur	Signification
SL_BRT_DATA	Obtient une valeur qui spécifie si l’ordinateur est authentique.
SL_BRT_COMMIT	Obtient une valeur qui spécifie si l’ordinateur est en mode de période de grâce non genuine.
SL_GENUINE_RESULT	Obtient la valeur retournée à partir du dernier appel à la fonction SLAcquireGenuineTicket .
SL_NONGENUINE_GRACE_FLAG	Obtient la cause de la mise en mode période de grâce non genuine de l’ordinateur.

[out, optional] peDataType

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

[out] pcbValue

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

[out] ppbValue

Adresse d’un pointeur vers un tableau de pointeurs BYTE qui spécifie la valeur associée au nom spécifié par le paramètre pwszValueName .

Lorsque vous avez terminé d’utiliser ce tableau, libérez-le en appelant la fonction LocalFree .

Valeur retournée

Si la méthode réussit, elle retourne S_OK.

En cas d'échec de la méthode, retourne un code d'erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Cette fonction peut retourner les valeurs suivantes définies dans Slerror.h.

Code/valeur de retour	Description
SL_E_NOT_SUPPORTED 0xC004F016	Le nom spécifié par le paramètre pwszValueName n’est pas pris en charge.
SL_E_VALUE_NOT_FOUND 0xC004F012	La paire nom-valeur spécifiée est introuvable.

Configuration requise


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

Voir aussi

SLDATATYPE

SLGetWindowsInformation

Partager via