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 |
|---|---|
|
Das angegebene Name-Wert-Paar wurde nicht gefunden. |
|
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 |