Partager via


SlGetWindowsInformation, fonction (slpublic.h)

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