Funzione SLGetGenuineInformation (slpublic.h)

Articolo
08/26/2023

Ottiene informazioni sullo stato originale di un computer Windows.

Sintassi

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

Parametri

[in] pQueryId

Puntatore a una struttura SLID che specifica l'applicazione da controllare.

[in] pwszValueName

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

Valore	Significato
SL_BRT_DATA	Ottiene un valore che specifica se il computer è originale.
SL_BRT_COMMIT	Ottiene un valore che specifica se il computer è in modalità periodo di tolleranza nongenuina.
SL_GENUINE_RESULT	Ottenere il valore restituito dall'ultima chiamata alla funzione SLAcquireGenuineTicket .
SL_NONGENUINE_GRACE_FLAG	Ottiene la causa dell'inserimento del computer in modalità periodo di tolleranza nongenuina.

[out, optional] peDataType

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

[out] pcbValue

Puntatore alla dimensione, in byte, del buffer ppbValue .

[out] ppbValue

Indirizzo di un puntatore a una matrice di puntatori BYTE che specifica il valore associato al nome specificato dal parametro pwszValueName .

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 Slerror.h.

Codice/valore restituito	Descrizione
SL_E_NOT_SUPPORTED 0xC004F016	Il nome specificato dal parametro pwszValueName non è supportato.
SL_E_VALUE_NOT_FOUND 0xC004F012	La coppia nome-valore specificata non è stata trovata.

Requisiti


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

Vedi anche

SLDATATYPE

SLGetWindowsInformation

Condividi tramite