Partager via

SlGetGenuineInformation, fonction (slpublic.h)

  • Article

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