SLQueryLicenseValueFromApp-Funktion (slpublic.h)

  • Artikel

[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
E_INVALIDARG
0x80070057
 Mindestens ein Argument ist ungültig.
SL_E_VALUE_NOT_FOUND
0xC004F012
 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