SLGetGenuineInformation-Funktion (slpublic.h)

Artikel
08/26/2023

Ruft Informationen zum Originalzustand eines Windows-Computers ab.

Syntax

HRESULT SLGetGenuineInformation(
  [in]            const SLID *pQueryId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           BYTE       **ppbValue
);

Parameter

[in] pQueryId

Ein Zeiger auf eine SLID-Struktur , die die zu überprüfende Anwendung angibt.

[in] pwszValueName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen enthält, der dem abzurufenden Wert zugeordnet ist. Die folgenden Namen sind gültig.

Wert	Bedeutung
SL_BRT_DATA	Ruft einen Wert ab, der angibt, ob der Computer original ist.
SL_BRT_COMMIT	Rufen Sie einen Wert ab, der angibt, ob sich der Computer im Nicht-Kulanzzeitmodus befindet.
SL_GENUINE_RESULT	Ruft den Wert ab, der beim letzten Aufruf der SLAcquireGenuineTicket-Funktion zurückgegeben wurde.
SL_NONGENUINE_GRACE_FLAG	Ruft die Ursache für den Computer ab, der in den Nicht-Kulanzzeitmodus versetzt wird.

[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

Die Adresse eines Zeigers auf ein Array von BYTE-Zeigern , die 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 Funktion LocalFree aufrufen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

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
SL_E_NOT_SUPPORTED 0xC004F016	Der vom parameter pwszValueName angegebene Name wird nicht unterstützt.
SL_E_VALUE_NOT_FOUND 0xC004F012	Das angegebene Name-Wert-Paar wurde nicht gefunden.

Anforderungen


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

Weitere Informationen

SLDATATYPE

SLGetWindowsInformation

Freigeben über