Interfaccia ICspStatus (certenroll.h)
Un oggetto ICspStatus contiene informazioni su una coppia provider/algoritmo di crittografia. L'oggetto viene usato principalmente dal controllo di registrazione certificati per consentire a un utente di selezionare i provider e gli algoritmi di crittografia da usare durante la creazione di una richiesta di certificato. Può essere recuperato, da solo o in un insieme ICspStatuses , chiamando le proprietà o i metodi seguenti:
| Proprietà/Metodo | Interfaccia | Descrizione |
|---|---|---|
| GetCspStatusFromOperations | ICspInformation | Crea un oggetto ICspStatus per il primo algoritmo supportato coerente con un identificatore di oggetto dell'algoritmo (OID) e un tipo di algoritmo specificati. |
| GetCspStatusesFromOperations | ICspInformations | Crea un insieme ICspStatuses per un tipo di algoritmo specificato e informazioni facoltative sul provider. Nota Il controllo registrazione certificati usa una raccolta ICspStatuses solo per la selezione dell'algoritmo asimmetrico della chiave privata (crittografia, firma e scambio di chiavi).
|
| GetCspStatusFromProviderName | ICspInformations | Crea un oggetto ICspStatus per un provider legacy in base al nome del provider e alle operazioni di chiave supportate. |
| CspStatus | IX509PrivateKey | Specifica o recupera un oggetto ICspStatus . L'oggetto viene in genere creato durante il processo di registrazione. |
| GetCspStatuses | IX509CertificateRequestPkcs10 | Crea un insieme ICspStatuses che contiene tutte le coppie provider/algoritmo coerenti con l'uso previsto della chiave privata come specificato dal chiamante. |
| CspStatuses | IX509CertificateRequestPkcs10 | Crea un insieme ICspStatuses che contiene tutte le coppie provider/algoritmo coerenti con l'uso previsto della chiave privata, come identificato dall'oggetto IX509PrivateKey associato alla richiesta di certificato. |
Poiché i provider di crittografia supportano in genere più algoritmi, è possibile creare e restituire più oggetti ICspStatus quando si chiama una delle proprietà o dei metodi precedenti che restituiscono una raccolta. Questa immagine è illustrata nella figura seguente:
È possibile utilizzare la proprietà EnrollmentStatus in un oggetto ICspStatus per recuperare un oggetto IX509EnrollmentStatus che definisce le proprietà seguenti:
- La proprietà Display specifica se la coppia provider/algoritmo può essere visualizzata in un'interfaccia utente.
- La proprietà Selected specifica o recupera un valore che indica se lo stato di un elemento specifico viene monitorato durante il processo di registrazione.
- La proprietà Status identifica lo stato del processo di registrazione.
Ereditarietà
L'interfaccia ICspStatus eredita dall'interfaccia IDispatch . ICspStatus include anche questi tipi di membri:
Metodi
L'interfaccia ICspStatus include questi metodi.
| ICspStatus::get_CspAlgorithm Recupera un oggetto ICspAlgorithm che contiene informazioni su un algoritmo supportato dal provider. |
| ICspStatus::get_CspInformation Recupera un oggetto ICspInformation che contiene informazioni generali sul provider. |
| ICspStatus::get_DisplayName Recupera una stringa contenente il nome del provider, il nome dell'algoritmo e le operazioni che possono essere eseguite dall'algoritmo. |
| ICspStatus::get_EnrollmentStatus Recupera un oggetto IX509EnrollmentStatus che contiene informazioni sulla registrazione del certificato. |
| ICspStatus::get_Ordinal Specifica o recupera la posizione dell'oggetto ICspStatus nell'insieme ICspStatuses. (Get) |
| ICspStatus::Initialize Inizializza l'oggetto da un provider di crittografia e da un algoritmo associato. |
| ICspStatus::p ut_Ordinal Specifica o recupera la posizione dell'oggetto ICspStatus nell'insieme ICspStatuses. (Put) |
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 |