Funzione SLGetWindowsInformation (slpublic.h)

  • Articolo

Recupera la parte valore di una coppia nome-valore dai criteri di licenza di un componente software.

Sintassi

HRESULT SLGetWindowsInformation(
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Parametri

[in] pwszValueName

Puntatore a una stringa con terminazione Null contenente il nome associato al valore da recuperare.

[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

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_VALUE_NOT_FOUND
0xC004F012
 La coppia nome-valore specificata non è stata trovata.
SL_E_RIGHT_NOT_GRANTED
0xC004F013
 Il chiamante non dispone delle autorizzazioni necessarie per chiamare questa funzione.

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