Metodo ICspStatuses::get_ItemByOrdinal (certenroll.h)

Articolo
08/22/2023

La proprietà ItemByOrdinal recupera un oggetto ICspStatus dall'insieme in base al numero ordinale.

Questa proprietà è di sola lettura.

Sintassi

HRESULT get_ItemByOrdinal(
  LONG       Ordinal,
  ICspStatus **ppValue
);

Parametri

Ordinal

ppValue

Valore restituito

nessuno

Osservazioni

L'ordine ordinale degli oggetti ICspStatus nell'insieme può variare ogni volta che la raccolta viene enumerata per diversi motivi, tra cui, a titolo esemplificativo, quanto segue:

Impostazioni del modello di richiesta certificato
Valori delle proprietà per il provider di crittografia
Valori delle proprietà della chiave privata

Si supponga, ad esempio, che il modello versione 2 scelto per creare una richiesta di certificato specifichi che il certificato può essere usato solo per la firma (l'attributo del modello pKIDefaultKeySpec è XCN_AT_SIGNATURE) e che il provider predefinito è Microsoft Enhanced RSA e AES Cryptographic Provider. Si noti che il modello limita la firma del certificato anche se il provider supporta sia algoritmi di crittografia che di firma. Ovvero, la proprietà KeySpec nel provider è una combinazione bit per bit delle costanti XCN_AT_KEYEXCHANGE e XCN_AT_SIGNATURE, ma l'attributo modello pKIDefaultKeySpec supporta solo XCN_AT_SIGNATURE.

Gli oggetti ICspStatus nell'insieme verranno ordinati nel modo seguente:

Degli oggetti ICspStatus enumerati per questo provider, quelli associati agli algoritmi di firma (XCN_AT_SIGNATURE) vengono ordinati per primi (valore ordinale inferiore) e le relative proprietà Display e Selected sono abilitate.
Nota Se l'attributo modello pKIDefaultKeySpec era stato XCN_AT_KEYEXCHANGE, gli algoritmi di crittografia verranno ordinati per primi.
Degli oggetti ICspStatus enumerati per questo provider, quelli associati agli algoritmi di crittografia (XCN_AT_KEYEXCHANGE) vengono ordinati in un secondo momento (valori ordinali superiori) e le relative proprietà Display e Selected non sono abilitate.
Per tutti gli altri provider CryptoAPI installati che supportano algoritmi di firma asimmetrica (XCN_AT_SIGNATURE), ma che non sono associati al provider specificato, la proprietà Display è abilitata e la proprietà Selected non è abilitata.
Per tutti gli altri provider CryptoAPI installati che supportano algoritmi di crittografia asimmetrica (XCN_AT_KEYEXCHANGE), le proprietà Display e Selected non sono abilitate.
Per tutte le API di crittografia installate: provider CNG (Next Generation), le proprietà Display e Selected non sono abilitate.

Per un altro esempio, si supponga che un modello versione 3 specifichi un provider e un algoritmo CNG specifici. La coppia provider/algoritmo (oggetto ICspStatus ) viene ordinata per prima, abilitata per la visualizzazione e l'opzione selezionata. Tutti gli altri algoritmi supportati da tale provider vengono ordinati in un secondo momento, non abilitati per la visualizzazione e non selezionati. Tutti gli altri provider che supportano l'algoritmo specificato verranno ordinati in un secondo momento, abilitati per la visualizzazione, ma non selezionati. Tutte le coppie provider/algoritmo rimanenti non verranno abilitate per la visualizzazione e non selezionate.

Nota I provider CNG non supportano il concetto di utilizzo previsto per KeySpec . Restituiscono XCN_AT_NONE per questo valore della proprietà.

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

ICspStatus

ICspStatuses

Condividi tramite