SlGetWindowsInformation, fonction (slpublic.h)

Article
03/02/2024

Récupère la partie valeur d’une paire nom-valeur à partir de la stratégie de licence d’un composant logiciel.

Syntaxe

HRESULT SLGetWindowsInformation(
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Paramètres

[in] pwszValueName

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

[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

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_VALUE_NOT_FOUND 0xC004F012	La paire nom-valeur spécifiée est introuvable.
SL_E_RIGHT_NOT_GRANTED 0xC004F013	L’appelant ne dispose pas des autorisations nécessaires pour appeler cette fonction.

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