Método ICspStatus::get_Ordinal (certenroll.h)

  • Artículo

La propiedad Ordinal especifica o recupera la posición del objeto ICspStatus en la colección ICspStatuses .

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_Ordinal(
  LONG *pValue
);

Parámetros

pValue

Valor devuelto

None

Observaciones

Para recorrer en iteración la colección ICspStatuses por ordinal, llame a la propiedad ItemByOrdinal . 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