Método ICspStatus::get_Ordinal (certenroll.h)
A propriedade Ordinal especifica ou recupera a posição do objeto ICspStatus na coleção ICspStatuses .
Essa propriedade é leitura/gravação.
Sintaxe
HRESULT get_Ordinal(
LONG *pValue
);
Parâmetros
pValue
Valor retornado
Nenhum
Comentários
Para iterar por meio da coleção ICspStatuses por ordinal, chame a propriedade ItemByOrdinal . A ordem ordinal dos objetos ICspStatus na coleção pode variar sempre que a coleção é enumerada por uma variedade de motivos, incluindo, mas não se limitando a, o seguinte:
- Configurações de modelo de solicitação de certificado
- Valores de propriedade para o provedor criptográfico
- Valores de propriedade de chave privada
Por exemplo, suponha que o modelo de versão 2 escolhido para criar uma solicitação de certificado especifique que o certificado só pode ser usado para assinatura (o atributo de modelo pKIDefaultKeySpec é XCN_AT_SIGNATURE) e que o provedor padrão é o Provedor criptográfico microsoft Enhanced RSA e AES. Observe que o modelo restringe o certificado à assinatura, embora o provedor dê suporte a algoritmos de criptografia e assinatura. Ou seja, a propriedade KeySpec no provedor é uma combinação bit a bit das constantes XCN_AT_KEYEXCHANGE e XCN_AT_SIGNATURE, mas o atributo de modelo pKIDefaultKeySpec dá suporte apenas a XCN_AT_SIGNATURE.
Os objetos ICspStatus na coleção serão ordenados da seguinte maneira:
- Dos objetos ICspStatus enumerados para esse provedor, aqueles associados a algoritmos de assinatura (XCN_AT_SIGNATURE) são ordenados primeiro (valor ordinal inferior) e suas propriedades Display e Selected estão habilitadas. Nota Se o atributo de modelo pKIDefaultKeySpec tivesse sido XCN_AT_KEYEXCHANGE, os algoritmos de criptografia seriam ordenados primeiro.
- Dos objetos ICspStatus enumerados para esse provedor, aqueles associados a algoritmos de criptografia (XCN_AT_KEYEXCHANGE) são ordenados posteriormente (valores ordinais mais altos) e suas propriedades Display e Selected não estão habilitadas.
- Para todos os outros provedores de CryptoAPI instalados que dão suporte a algoritmos de assinatura assimétrica (XCN_AT_SIGNATURE), mas que não estão associados ao provedor especificado, a propriedade Display está habilitada e a propriedade Selected não está habilitada.
- Para todos os outros provedores de CryptoAPI instalados que dão suporte a algoritmos de criptografia assimétrica (XCN_AT_KEYEXCHANGE), as propriedades Display e Selected não estão habilitadas.
- Para todos os provedores instalados da API de Criptografia: CNG (Próxima Geração), as propriedades Display e Selected não estão habilitadas.
Por outro exemplo, suponha que um modelo de versão 3 especifique um provedor E algoritmo CNG específicos. Esse par de provedor/algoritmo (objeto ICspStatus ) é ordenado primeiro, habilitado para exibição e selecionado. Todos os outros algoritmos compatíveis com esse provedor são ordenados posteriormente, não habilitados para exibição e não selecionados. Todos os outros provedores que dão suporte ao algoritmo especificado serão ordenados posteriormente ainda, habilitados para exibição, mas não selecionados. Todos os pares de provedor/algoritmo restantes não serão habilitados para exibição e não serão selecionados.
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 |