Método ICspStatuses::get_ItemByProvider (certenroll.h)
A propriedade ItemByProvider recupera um objeto ICspStatus que tem o mesmo nome do provedor especificado na entrada, mas identifica um algoritmo que dá suporte a um uso de chave pretendido diferente.
Esta propriedade é somente para leitura.
Sintaxe
HRESULT get_ItemByProvider(
ICspStatus *pCspStatus,
ICspStatus **ppValue
);
Parâmetros
pCspStatus
ppValue
Valor retornado
Nenhum
Comentários
A propriedade ItemByProvider recupera o objeto ICspStatus que corresponde ao nome do provedor de entrada, mas está associado a um valor de enumeração X509KeySpec diferente. Por exemplo, se o provedor de entrada tiver um valor KeySpec de XCN_AT_KEYEXCHANGE, a propriedade ItemByProvider tentará localizar um objeto ICspStatus para o mesmo provedor, mas com um valor KeySpec de XCN_AT_SIGNATURE.
Como a propriedade KeySpec só está associada a provedores herdados, se você especificar uma API de Criptografia: provedores CNG (Próxima Geração), a propriedade ItemByProvider retornará o mesmo objeto ICspStatus que o inserido.
Para usar essa propriedade para iterar por meio da coleção, execute as seguintes etapas:
- Recupere uma coleção ICspStatuses chamando o método GetCspStatuses ou a propriedade CspStatuses na interface IX509CertificateRequestPkcs10 .
- Chame a propriedade ItemByIndex para iterar por meio da coleção.
- Para cada elemento ICspStatus recuperado que contém o provedor no qual você está interessado, chame ItemByProvider.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | certenroll.h |
| DLL | CertEnroll.dll |