Funzione SLSetGenuineInformation (slpublic.h)
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.
[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 |
---|---|
|
Il chiamante non dispone di privilegi amministrativi. |
|
Il parametro pbValue non può essere NULL. |
|
Il buffer pbValue è troppo piccolo per contenere i dati. |
|
Il tipo di dati del parametro pbValue non corrisponde al tipo specificato dal parametro eDataType . |
|
La coppia nome-valore specificata dipende da una coppia nome-valore non impostata. |
|
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 |