Funzione SLInstallProofOfPurchase (slpublic.h)

  • Articolo

Registra il codice Product Key con SL.

Sintassi

HRESULT SLInstallProofOfPurchase(
  [in]           HSLC   hSLC,
  [in]           PCWSTR pwszPKeyAlgorithm,
  [in]           PCWSTR pwszPKeyString,
  [in]           UINT   cbPKeySpecificData,
  [in, optional] PBYTE  pbPKeySpecificData,
  [out]          SLID   *pPkeyId
);

Parametri

[in] hSLC

Tipo: HSLC

Handle nel contesto SLC corrente.

[in] pwszPKeyAlgorithm

Tipo: PCWSTR

Algoritmo Product Key.

[in] pwszPKeyString

Tipo: PCWSTR

Stringa chiave prodotto.

[in] cbPKeySpecificData

Tipo: UINT

Dimensioni, in byte, di dati specifici della chiave prodotto. Se non sono presenti dati specifici PKey, impostare cbPKeySpecificData su 0.

[in, optional] pbPKeySpecificData

Tipo: PBYTE

Puntatore ai dati specifici del codice Product Key. Se non sono presenti dati specifici di PKey, impostare pbPKeySpecificData su NULL.

[out] pPkeyId

Tipo: SLID*

Puntatore a un identificatore della chiave prodotto registrata. Questo SLID può essere usato per fare riferimento alle informazioni PKey in un secondo momento.

Valore restituito

Tipo: HRESULT WINAPI

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Codice/valore restituito Descrizione
E_INVALIDARG
0x80070057
 Uno o più argomenti non sono validi.
E_ACCESSDENIED
0x80070005
 Accesso negato (l'API richiede privilegi di amministratore).
SL_E_LUA_ACCESSDENIED
0xC004F025
 L'azione richiede privilegi di amministratore.
SL_E_INVALID_PKEY
0xC004F010
 Il codice Product Key non è valido.
SL_E_PRODUCT_SKU_NOT_INSTALLED
0xC004F015
 La licenza non è installata.
SL_E_PKEY_INVALID_UPGRADE
0xC004F061
 Questo codice Product Key specificato può essere usato solo per l'aggiornamento, non per installazioni pulite.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione slpublic.h
Libreria Slc.lib
DLL Slc.dll