Fonction SLSetGenuineInformation (slpublic.h)

Article
03/13/2024

Spécifie des informations sur la status d’origine d’un ordinateur Windows.

Syntaxe

HRESULT SLSetGenuineInformation(
  [in]           const SLID *pQueryId,
  [in]           PCWSTR     pwszValueName,
  [in]           SLDATATYPE eDataType,
  [in, optional] UINT       cbValue,
  [in, optional] const BYTE *pbValue
);

Paramètres

[in] pQueryId

Pointeur vers une structure SLID qui spécifie l’application pour laquelle définir des informations.

[in] pwszValueName

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

Valeur	Signification
SL_BRT_DATA	Définissez des informations sur l’état réel de l’ordinateur.
SL_BRT_COMMIT	Si la valeur SL_BRT_DATA est définie, la définition de SL_BRT_COMMIT place l’ordinateur en mode période de grâce non classique.

[in] eDataType

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

[in, optional] cbValue

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

[in, optional] pbValue

Pointeur vers un tableau de valeurs BYTE qui spécifient la valeur associée au nom spécifié par le paramètre pwszValueName .

Certaines paires nom-valeur permettent à ce paramètre d’être NULL. Dans ce cas, la valeur existante de la paire nom-valeur est supprimée.

Une fois que 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 Winerror.h et Slerror.h.

Code/valeur de retour	Description
E_ACCESS_DENIED 0x80070005	L’appelant ne dispose pas de privilèges administratifs.
E_INVALIDARG 0x80000003	Le paramètre pbValue ne peut pas être NULL.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW 0x111	La mémoire tampon pbValue est trop petite pour contenir les données.
SL_E_DATATYPE_MISMATCHED 0xC004F01E	Le type de données du paramètre pbValue ne correspond pas au type spécifié par le paramètre eDataType .
SL_E_DEPENDENT_PROPERTY_NOT_SET 0xC004F066	La paire nom-valeur spécifiée dépend d’une paire nom-valeur qui n’a pas été définie.
SL_E_NOT_SUPPORTED 0xC004F016	Le nom spécifié par le paramètre pwszValueName n’est pas pris en charge.

Configuration requise

Condition requise	Valeur
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

Partager via