Método ICspStatuses::get_ItemByOrdinal (certenroll.h)

  • Artículo

La propiedad ItemByOrdinal recupera un objeto ICspStatus de la colección por número ordinal.

Esta propiedad es de solo lectura.

Sintaxis

HRESULT get_ItemByOrdinal(
  LONG       Ordinal,
  ICspStatus **ppValue
);

Parámetros

Ordinal

ppValue

Valor devuelto

None

Observaciones

El orden ordinal de los objetos ICspStatus de la colección puede variar cada vez que la colección se enumera por diversos motivos, entre los que se incluyen, entre otros:

  • Configuración de la plantilla de solicitud de certificado
  • Valores de propiedad para el proveedor criptográfico
  • Valores de propiedad de clave privada

Por ejemplo, supongamos que la plantilla de la versión 2 elegida para crear una solicitud de certificado especifica que el certificado solo se puede usar para firmar (el atributo de plantilla pKIDefaultKeySpec es XCN_AT_SIGNATURE) y que el proveedor predeterminado es el proveedor RSA mejorado de Microsoft y el proveedor criptográfico AES. Observe que la plantilla restringe el certificado a la firma aunque el proveedor admita algoritmos de cifrado y firma. Es decir, la propiedad KeySpec del proveedor es una combinación bit a bit de las constantes XCN_AT_KEYEXCHANGE y XCN_AT_SIGNATURE, pero el atributo de plantilla pKIDefaultKeySpec solo admite XCN_AT_SIGNATURE.

Los objetos ICspStatus de la colección se ordenarán de la siguiente manera:

  • De los objetos ICspStatus enumerados para este proveedor, los asociados a algoritmos de firma (XCN_AT_SIGNATURE) se ordenan primero (valor ordinal inferior) y sus propiedades Display y Selected están habilitadas.
    Nota Si el atributo de plantilla pKIDefaultKeySpec se hubiera XCN_AT_KEYEXCHANGE, los algoritmos de cifrado se ordenarían primero.
     
  • De los objetos ICspStatus enumerados para este proveedor, los asociados a algoritmos de cifrado (XCN_AT_KEYEXCHANGE) se ordenan más adelante (valores ordinales superiores) y sus propiedades Display y Selected no están habilitadas.
  • Para todos los demás proveedores cryptoAPI instalados que admiten algoritmos de firma asimétricos (XCN_AT_SIGNATURE), pero que no están asociados con el proveedor especificado, la propiedad Display está habilitada y la propiedad Selected no está habilitada.
  • Para todos los demás proveedores cryptoAPI instalados que admiten algoritmos de cifrado asimétrico (XCN_AT_KEYEXCHANGE), las propiedades Mostrar y Seleccionados no están habilitadas.
  • Para todos los proveedores de Cryptography API: Next Generation (CNG) instalados, las propiedades Display y Selected no están habilitadas.

En otro ejemplo, supongamos que una plantilla de la versión 3 especifica un proveedor y un algoritmo de CNG específicos. Ese par proveedor/algoritmo (objeto ICspStatus ) se ordena primero, habilitado para mostrar y seleccionar. Todos los demás algoritmos admitidos por ese proveedor se ordenan más adelante, no se habilitan para mostrar y no están seleccionados. Todos los demás proveedores que admitan el algoritmo especificado se ordenarán más adelante, habilitados para mostrar, pero no seleccionados. Todos los pares de proveedor o algoritmo restantes no se habilitarán para mostrar y no se seleccionarán.

Nota Los proveedores de CNG no admiten el concepto de uso previsto de KeySpec . Devuelven XCN_AT_NONE para este valor de propiedad.

 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

ICspStatus

ICspStatuses