Método ICspStatus::get_Ordinal (certenroll.h)
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.
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 |