Metodo ICspStatuses::get_ItemByProvider (certenroll.h)
La proprietà ItemByProvider recupera un oggetto ICspStatus con lo stesso nome del provider specificato nell'input, ma identifica un algoritmo che supporta un uso di chiave previsto diverso.
Questa proprietà è di sola lettura.
Sintassi
HRESULT get_ItemByProvider(
ICspStatus *pCspStatus,
ICspStatus **ppValue
);
Parametri
pCspStatus
ppValue
Valore restituito
nessuno
Osservazioni
La proprietà ItemByProvider recupera l'oggetto ICspStatus che corrisponde al nome del provider di input, ma è associato a un valore di enumerazione X509KeySpec diverso. Ad esempio, se il provider di input ha un valore KeySpec di XCN_AT_KEYEXCHANGE, la proprietà ItemByProvider tenta di trovare un oggetto ICspStatus per lo stesso provider, ma con un valore KeySpec di XCN_AT_SIGNATURE.
Poiché la proprietà KeySpec è associata solo ai provider legacy, se si specifica un'API di crittografia: provider CNG (Next Generation), la proprietà ItemByProvider restituisce lo stesso oggetto ICspStatus immesso.
Per usare questa proprietà per scorrere la raccolta, seguire questa procedura:
- Recuperare un insieme ICspStatuses chiamando il metodo GetCspStatuses o la proprietà CspStatuses nell'interfaccia IX509CertificateRequestPkcs10.
- Chiamare la proprietà ItemByIndex per scorrere l'insieme.
- Per ogni elemento ICspStatus recuperato che contiene il provider interessato, chiamare ItemByProvider.
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 |