Freigeben über

SLSetGenuineInformation-Funktion (slpublic.h)

  • Artikel

Gibt Informationen zum originalen status eines Windows-Computers an.

Syntax

HRESULT SLSetGenuineInformation(
  [in]           const SLID *pQueryId,
  [in]           PCWSTR     pwszValueName,
  [in]           SLDATATYPE eDataType,
  [in, optional] UINT       cbValue,
  [in, optional] const BYTE *pbValue
);

Parameter

[in] pQueryId

Ein Zeiger auf eine SLID-Struktur , der die Anwendung angibt, für die Informationen festgelegt werden sollen.

[in] pwszValueName

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

Wert Bedeutung
SL_BRT_DATA
 Legen Sie Informationen über den Originalzustand des Computers fest.
SL_BRT_COMMIT
 Wenn der wert für den SL_BRT_DATA festgelegt ist, versetzt die Einstellung SL_BRT_COMMIT den Computer in den nicht standardmäßigen Toleranzperiodenmodus.

[in] eDataType

Ein Zeiger auf einen Wert der SLDATATYPE-Enumeration , der den Datentyp im pbValue-Puffer angibt.

[in, optional] cbValue

Ein Zeiger auf die Größe des pbValue-Puffers in Byte.

[in, optional] pbValue

Ein Zeiger auf ein Array von BYTE-Werten , die den Wert angeben, der dem durch den pwszValueName-Parameter angegebenen Namen zugeordnet ist.

Einige Name-Wert-Paare ermöglichen es, dass dieser Parameter NULL ist. In diesem Fall wird der vorhandene Wert des Name-Wert-Paars gelöscht.

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 Winerror.h und Slerror.h definiert sind.

Rückgabecode/-wert BESCHREIBUNG
E_ACCESS_DENIED
0x80070005
 Der Aufrufer verfügt nicht über Administratorrechte.
E_INVALIDARG
0x80000003
 Der pbValue-Parameter darf nicht NULL sein.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW
0x111
 Der pbValue-Puffer ist zu klein, um die Daten aufzunehmen.
SL_E_DATATYPE_MISMATCHED
0xC004F01E
 Der Datentyp des pbValue-Parameters stimmt nicht mit dem vom eDataType-Parameter angegebenen Typ überein.
SL_E_DEPENDENT_PROPERTY_NOT_SET
0xC004F066
 Das angegebene Name-Wert-Paar ist von einem Namen-Wert-Paar abhängig, das nicht festgelegt wurde.
SL_E_NOT_SUPPORTED
0xC004F016
 Der vom parameter pwszValueName angegebene Name wird nicht unterstützt.

Anforderungen

Anforderung Wert
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