SLGetWindowsInformation-Funktion (slpublic.h)

Ruft den Wertteil eines Name-Wert-Paares aus der Lizenzierungsrichtlinie einer Softwarekomponente ab.

Syntax

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

Parameter

[in] pwszValueName

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen enthält, der dem abzurufenden Wert zugeordnet ist.

[out, optional] peDataType

Ein Zeiger auf einen Wert der SLDATATYPE-Enumeration , der den Datentyp im ppbValue-Puffer angibt.

[out] pcbValue

Ein Zeiger auf die Größe des ppbValue-Puffers in Bytes.

[out] ppbValue

Ein Zeiger auf ein Array von BYTE-Zeigern , das den Wert angibt, der dem durch den pwszValueName-Parameter angegebenen Namen zugeordnet ist.

Wenn Sie die Verwendung dieses Arrays abgeschlossen haben, geben Sie es frei, indem Sie die LocalFree-Funktion aufrufen.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück.

Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Diese Funktion kann die folgenden werte zurückgeben, die in Slerror.h definiert sind.

Rückgabecode/-wert	BESCHREIBUNG
SL_E_VALUE_NOT_FOUND 0xC004F012	Das angegebene Name-Wert-Paar wurde nicht gefunden.
SL_E_RIGHT_NOT_GRANTED 0xC004F013	Der Aufrufer verfügt nicht über die erforderlichen Berechtigungen, um diese Funktion aufzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	slpublic.h
Bibliothek	Slc.lib
DLL	Slc.dll