Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Diese API ist nicht für alle Windows-/Windows Phone-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wurde, schlagen Aufrufe dieser APIs zur Laufzeit fehl.]
Ruft den Wert für die angegebene Komponentenrichtlinie ab.
Syntax
HRESULT SLQueryLicenseValueFromApp(
[in] PCWSTR valueName,
[out, optional] ULONG *valueType,
[out, optional] PVOID dataBuffer,
[in] ULONG dataSize,
[out] ULONG *resultDataSize
);
Parameter
[in] valueName
Der Name der Richtlinie, für die Sie Informationen abrufen möchten.
[out, optional] valueType
Der Datentyp des Richtlinienwerts. In der folgenden Tabelle werden die Werte beschrieben, die dieser Parameter empfangen kann.
| Wert | BESCHREIBUNG |
|---|---|
| REG_DWORD | Eine 32-Bit-Ganzzahl. Für diesen Typ sollte die Größe des Puffers, den der dataBuffer-Parameter angibt, mindestens 4 Byte betragen. |
| REG_BINARY | Ein binärer Wert. |
| REG_SZ | Eine Breitzeichenzeichenfolge mit NULL-Termin, einschließlich des letzten NULL-Zeichens. |
[out, optional] dataBuffer
Ein Puffer, der den Wert der Komponentenrichtlinie empfängt.
[in] dataSize
Die Größe des bereitgestellten Puffers in Bytes.
[out] resultDataSize
Die tatsächliche Größe der für den Richtlinienwert empfangenen Daten in Bytes.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
| Wert | Bedeutung |
|---|---|
|
Mindestens ein Argument ist ungültig. |
|
Das angegebene Name-Wert-Paar wurde nicht gefunden. |
Hinweise
Ihre App muss über die eingeschränkte slapiQueryLicenseValue-Funktion verfügen, um die SLQueryLicenseValueFromApp-Funktion aufzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | slpublic.h |
| Bibliothek | Api-ms-win-core-slapi-l1-1-0.lib |
| DLL | Api-ms-win-core-slapi-l1-1-0.dll |