Freigeben über

SLGetApplicationInformation-Funktion (slpublic.h)

  • Artikel

Ruft Informationen zur angegebenen Anwendung ab.

Syntax

HRESULT SLGetApplicationInformation(
  [in]            HSLC       hSLC,
  [in]            const SLID *pApplicationId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Parameter

[in] hSLC

Typ: HSLC

Das Handle für den aktuellen SLC-Kontext.

[in] pApplicationId

Typ: const SLID*

Ein Zeiger auf die Anwendungs-ID.

[in] pwszValueName

Typ: PCWSTR

Wert Bedeutung
SL_INFO_KEY_IS_KMS
L"IsKeyManagementService"
 Gibt an, ob auf dem Computer ein Schlüsselverwaltungsdienst (Key Management Service, KMS) aktiviert ist.
SL_INFO_KEY_KMS_CURRENT_COUNT
L"KeyManagementServiceCurrentCount"
 Die Anzahl der Volumeclients auf einem KMS-Host, die derzeit aktiv sind.
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT
L"KeyManagementServiceRequiredClientCount"
 Die Mindestanzahl von VL-Clients, die zum Aktivieren der Aktivierung eine Verbindung mit einem KMS-Host herstellen müssen.
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS
L"KeyManagementServiceUnlicensedRequests"
 Die Anzahl der KMS-Anforderungen von VL-Clients mit Lizenzstatus=Nicht lizenziert.
SL_INFO_KEY_KMS_LICENSED_REQUESTS
L"KeyManagementServiceLicensedRequests"
 Die Anzahl der KMS-Anforderungen von VL-Clients mit Lizenzstatus=Lizenziert.
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS
L"KeyManagementServiceOOBGraceRequests"
 Die Anzahl der KMS-Anforderungen von VL-Clients mit Lizenzstatus=OOB Grace.
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS
L"KeyManagementServiceOOTGraceRequests"
 Die Anzahl der KMS-Anforderungen von VL-Clients mit Lizenzstatus=OOT Grace.
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS
L"KeyManagementServiceNonGenuineGraceRequests"
 Die Anzahl der KMS-Anforderungen von VL-Clients mit Lizenzstatus=Non-Genuine Grace.
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS
L"KeyManagementServiceNotificationRequests"
 Die Anzahl der KMS-Anforderungen von VL-Clients mit Lizenzstatus=Benachrichtigung.
SL_INFO_KEY_KMS_TOTAL_REQUESTS
L"KeyManagementServiceTotalRequests"
 Gesamtzahl der gültigen KMS-Anforderungen.
SL_INFO_KEY_KMS_FAILED_REQUESTS
L"KeyManagementServiceFailedRequests"
 Gesamtanzahl der fehlgeschlagenen KMS-Anforderungen.

[out, optional] peDataType

Typ: SLDATATYPE*

Ein Zeiger auf einen Wert der SLDATATYPE-Enumeration , der den Datentyp im ppbValue-Puffer angibt. Die folgenden Werte sind gültig.

Wert Bedeutung
SL_DATA_SZ
 UNICODE-Zeichenfolge
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 Binäres Blob

[out] pcbValue

Typ: UINT*

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

[out] ppbValue

Typ: PBYTE*

Bei erfolgreicher Ausführung werden die Daten in dem puffer zurückgegeben, der vom SLC zugewiesen wurde.
Wenn Sie mit der Verwendung des Arbeitsspeichers fertig sind, geben Sie ihn frei, indem Sie die LocalFree-Funktion aufrufen.

Rückgabewert

Typ: HRESULT WINAPI

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Rückgabecode/-wert BESCHREIBUNG
E_INVALIDARG
0x80070057
 Mindestens ein Argument ist ungültig.
SL_E_VALUE_NOT_FOUND
0xC004F012
 Der Wert für den Eingabeschlüssel wurde nicht gefunden.

Anforderungen

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