Partager via

Fonction SLSetGenuineInformation (slpublic.h)

  • Article

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