Funzione SLSetGenuineInformation (slpublic.h)

  • Articolo

Specifica informazioni sullo stato originale di un computer Windows.

Sintassi

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

Parametri

[in] pQueryId

Puntatore a una struttura SLID che specifica l'applicazione per cui impostare le informazioni.

[in] pwszValueName

Puntatore a una stringa con terminazione Null contenente il nome associato al valore da impostare. I nomi seguenti sono validi.

Valore Significato
SL_BRT_DATA
 Impostare le informazioni sullo stato originale del computer.
SL_BRT_COMMIT
 Se il valore SL_BRT_DATA è impostato, l'impostazione SL_BRT_COMMIT imposta il computer in modalità periodo di tolleranza nongenuina.

[in] eDataType

Puntatore a un valore dell'enumerazione SLDATATYPE che specifica il tipo di dati nel buffer pbValue .

[in, optional] cbValue

Puntatore alla dimensione, in byte, del buffer pbValue .

[in, optional] pbValue

Puntatore a una matrice di valori BYTE che specificano il valore associato al nome specificato dal parametro pwszValueName .

Alcune coppie nome-valore consentono a questo parametro di essere NULL. In questo caso, il valore esistente della coppia nome-valore viene eliminato.

Al termine dell'uso di questa matrice, liberarlo chiamando la funzione LocalFree .

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, viene restituito un codice errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Questa funzione può restituire i valori seguenti definiti in Winerror.h e Slerror.h.

Codice/valore restituito Descrizione
E_ACCESS_DENIED
0x80070005
 Il chiamante non dispone di privilegi amministrativi.
E_INVALIDARG
0x80000003
 Il parametro pbValue non può essere NULL.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW
0x111
 Il buffer pbValue è troppo piccolo per contenere i dati.
SL_E_DATATYPE_MISMATCHED
0xC004F01E
 Il tipo di dati del parametro pbValue non corrisponde al tipo specificato dal parametro eDataType .
SL_E_DEPENDENT_PROPERTY_NOT_SET
0xC004F066
 La coppia nome-valore specificata dipende da una coppia nome-valore non impostata.
SL_E_NOT_SUPPORTED
0xC004F016
 Il nome specificato dal parametro pwszValueName non è supportato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione slpublic.h
Libreria Slc.lib
DLL Slc.dll