SLQueryLicenseValueFromApp-Funktion (slpublic.h)

Artikel
03/06/2024

[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

Freigeben über