Funzione SLGetGenuineInformation (slpublic.h)

  • Articolo

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