Metodo ICspInformation::InitializeFromType (certenroll.h)

  • Articolo

Il metodo InitializeFromType inizializza l'oggetto dal provider di crittografia predefinito.

Sintassi

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Parametri

[in] Type

Valore di enumerazione X509ProviderType che definisce il tipo di provider.

  • Se si specifica XCN_PROV_NONE e si imposta il parametro pAlgorithm su un valore diverso da NULL, viene usato il provider predefinito Cryptography API: Next Generation (CNG).
  • Se si specifica un valore diverso da XCN_PROV_NONE e si imposta il parametro pAlgorithm su NULL, viene usato il provider di servizi di crittografia legacy predefinito.If you specify a value than XCN_PROV_NONE and set the pAlgorithm parameter to NULL, the default legacy cryptographic service provider (CSP) is used.

[in, optional] pAlgorithm

Puntatore a un'interfaccia IObjectId che rappresenta un OID dell'algoritmo. Questo parametro è facoltativo e può essere NULL. Per altre informazioni, vedere il parametro Type .

[in] MachineContext

Variabile VARIANT_BOOL che indica se utilizzare il computer o il contesto utente per determinare il provider predefinito per il tipo di provider specificato. Specificare VARIANT_TRUE per il computer e VARIANT_FALSE per l'utente.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 L'oggetto è già inizializzato.

Commenti

Il metodo InitializeFromType convalida il tipo specificato e lo salva nella proprietà Type , recupera il provider predefinito e imposta i valori di proprietà seguenti nell'oggetto ICspInformation :

Il metodo aggiunge gli algoritmi disponibili all'insieme ICspAlgorithms restituito dalla proprietà CspAlgorithms . Chiamare il metodo InitializeFromName per inizializzare l'oggetto da un nome CSP.

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 certenroll.h
DLL CertEnroll.dll

Vedi anche

ICspInformation