Metodo ICspInformation::InitializeFromType (certenroll.h)

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.

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 :

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• Nome
• Valido
• Versione

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

Vedi anche

ICspInformation