Metodo ICspStatus::p ut_Ordinal (certenroll.h)

  • Articolo

La proprietà Ordinal specifica o recupera la posizione dell'oggetto ICspStatus nell'insieme ICspStatuses .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_Ordinal(
  LONG Value
);

Parametri

Value

Valore restituito

nessuno

Osservazioni

Per scorrere l'insieme ICspStatuses per ordinale, chiamare la proprietà ItemByOrdinal . 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