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

Confira também

ICspStatuses