Metodo ICspAlgorithm::GetAlgorithmOid (certenroll.h)

Articolo
08/22/2023

Il metodo GetAlgorithmOid recupera l'identificatore dell'oggetto dell'algoritmo (OID). Questo metodo è abilitato per Il Web.

Sintassi

HRESULT GetAlgorithmOid(
  [in]  LONG           Length,
  [in]  AlgorithmFlags AlgFlags,
  [out] IObjectId      **ppValue
);

Parametri

[in] Length

Variabile LONG che identifica le dimensioni necessarie della chiave dell'algoritmo di crittografia simmetrica. Usare questo parametro per recuperare un algoritmo AES specifico da un'API di crittografia: provider di archiviazione chiavi CNG (Next Generation) (KSP). Un KSP può elencare un solo algoritmo denominato AES, ma supporta tutte le varianti AES nell'elenco seguente:

szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2)
szOID_NIST_AES192_CBC (2.16.840.1.101.3.4.1.22)
szOID_NIST_AES256_CBC (2.16.840.1.101.3.4.1.42)
szOID_NIST_AES128_WRAP (2.16.840.1.101.3.4.1.5)
szOID_NIST_AES192_WRAP (2.16.840.1.101.3.4.1.25)
szOID_NIST_AES256_WRAP (2.16.840.1.101.3.4.1.45)

Se si specifica zero per il parametro Length e AlgorithmFlagsNone (0x00000000) per il parametro AlgFlags , viene recuperato l'OID associato all'algoritmo predefinito. Per Microsoft Software KSP e Microsoft Smart Card KSP, l'algoritmo AES predefinito è szOID_NIST_AES128_CBC (2.16.840.1.101.3.4.1.2).

Nota Questo parametro deve essere zero per qualsiasi algoritmo diverso da un algoritmo di crittografia simmetrica.

[in] AlgFlags

Valore di enumerazione AlgorithmFlags che specifica se cercare un algoritmo di wrapping delle chiavi. I valori possibili sono i seguenti:

AlgoritmoFlagsNone
AlgoritmoFlagsWrap

L'impostazione di AlgorithmFlagsWrap causa la ricerca di algoritmi per i quali il nome visualizzato termina con "wrapping". Sono inclusi gli OID seguenti:

szOID_NIST_AES128_WRAP (2.16.840.1.101.3.4.1.5)
szOID_NIST_AES192_WRAP (2.16.840.1.101.3.4.1.25)
szOID_NIST_AES256_WRAP (2.16.840.1.101.3.4.1.45)
XCN_OID_RSA_SMIMEalgCMS3DESwrap (1.2.840.113549.1.9.16.3.6)
XCN_OID_RSA_SMIMEalgCMSRC2wrap (1.2.840.113549.1.9.16.3.7)

Nota Questo parametro deve essere zero per qualsiasi algoritmo diverso da un algoritmo di crittografia simmetrica.

[out] ppValue

Indirizzo di una variabile che riceve un puntatore a un'interfaccia IObjectId che rappresenta l'OID dell'algoritmo.

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 di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito	Descrizione
CERTSRV_E_PROPERTY_EMPTY	Impossibile trovare l'OID dell'algoritmo.
OLE_E_BLANK	Le informazioni CSP non sono state inizializzate. Per altre informazioni, vedere l'interfaccia ICspInformation .

Commenti

È necessario chiamare il metodo InitializeFromName o il metodo InitializeFromType nell'interfaccia ICspInformation prima di chiamare GetAlgorithmOid.

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

ICspAlgorithm

Condividi tramite