Funciones del proveedor de servicios criptográficos
Cada una de las secciones siguientes identifica una función exportada por Xenroll.dll que se puede usar para administrar un proveedor criptográfico. En cada tema también se describe cómo usar CertEnroll.dll para reemplazar la función o indica que no existe ninguna asignación entre las dos bibliotecas:
- EnumAlgs
- enumContainersWStr
- enumProvidersWStr
- GetAlgNameWStr
- getProviderTypeWStr
- HashAlgID
- HashAlgorithmWStr
- ProviderFlags
- ProviderNameWStr
- ProviderType
- Temas relacionados
EnumAlgs
La función EnumAlgs de Xenroll.dll recupera una colección de algoritmos criptográficos.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar información sobre los algoritmos admitidos por un proveedor de servicios criptográficos (CSP):
- Llame a la propiedad Request en un objeto IX509Enrollment existente.
- Llame al método GetInnerRequest en la solicitud devuelta en el paso 1 para recuperar la solicitud más interna.
- Llame a QueryInterface en el objeto IX509CertificateRequest devuelto del paso 2 para convertir a un objeto IX509CertificateRequestPkcs10 .
- Llame a la propiedad PrivateKey en la solicitud PKCS #10.
- Llame a la propiedad CspInformations en el objeto IX509PrivateKey recuperado del paso 4.
- Llame a la propiedad CspAlgorithms en un objeto ICspInformation específico de la colección ICspInformations recuperada en el paso 5.
enumContainersWStr
La función enumContainersWStr de Xenroll.dll recupera un contenedor de claves de la colección por índice.
La biblioteca CertEnroll.dll no implementa directamente esta funcionalidad.
enumProvidersWStr
La función enumProvidersWStr de Xenroll.dll recupera un CSP de la colección por índice.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar la colección de contenedores criptográficos:
- Llame a la propiedad Request en un objeto IX509Enrollment existente.
- Llame al método GetInnerRequest en la solicitud devuelta en el paso 1 para recuperar la solicitud más interna.
- Llame a QueryInterface en el objeto IX509CertificateRequest devuelto del paso 2 para convertir a un objeto IX509CertificateRequestPkcs10 .
- Llame a la propiedad PrivateKey en la solicitud PKCS #10.
- Llame a la propiedad CspInformations en el objeto IX509PrivateKey recuperado del paso 4.
GetAlgNameWStr
La función GetAlgNameWStr de Xenroll.dll recupera el nombre de un algoritmo criptográfico.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar el nombre del algoritmo:
- Llame a la propiedad Request en un objeto IX509Enrollment existente.
- Llame al método GetInnerRequest en la solicitud devuelta en el paso 1 para recuperar la solicitud más interna.
- Llame a QueryInterface en el objeto IX509CertificateRequest devuelto del paso 2 para convertir a un objeto IX509CertificateRequestPkcs10 .
- Llame a la propiedad PrivateKey en la solicitud PKCS #10.
- Llame a la propiedad Algorithm en el objeto IX509PrivateKey para recuperar el identificador del objeto de algoritmo.
- Llame a la propiedad FriendlyName en la interfaz IObjectId para recuperar el nombre para mostrar del algoritmo.
getProviderTypeWStr
La función getProviderTypeWStr de Xenroll.dll recupera el tipo de proveedor criptográfico.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar el tipo de proveedor:
- Llame a la propiedad Request en un objeto IX509Enrollment existente.
- Llame al método GetInnerRequest en la solicitud devuelta en el paso 1 para recuperar la solicitud más interna.
- Llame a QueryInterface en el objeto IX509CertificateRequest devuelto del paso 2 para convertir a un objeto IX509CertificateRequestPkcs10 .
- Llame a la propiedad PrivateKey en la solicitud PKCS #10.
- Llame a la propiedad ProviderType en el objeto IX509PrivateKey recuperado del paso 4.
HashAlgID
La función HashAlgID de Xenroll.dll recupera un valor entero que contiene el identificador del algoritmo utilizado para firmar una solicitud.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar el algoritmo hash:
- Recupere una interfaz IX509SignatureInformation llamando a la propiedad SignatureInformation en una solicitud PKCS #10 o CMC o la propiedad SignerCertificate en una solicitud PKCS #7 .
- Llame a la propiedad HashAlgorithm en el objeto de información de firma para recuperar el identificador de objeto del algoritmo hash.
HashAlgorithmWStr
La función HashAlgorithmWStr de Xenroll.dll especifica o recupera un valor de cadena que identifica el algoritmo hash usado para firmar una solicitud.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar el algoritmo hash:
- Recupere una interfaz IX509SignatureInformation llamando a la propiedad SignatureInformation en una solicitud PKCS #10 o CMC o la propiedad SignerCertificate en una solicitud PKCS #7.
- Llame a la propiedad HashAlgorithm en el objeto de información de firma para recuperar el identificador de objeto del algoritmo hash.
- Llame a la propiedad FriendlyName en la interfaz IObjectId devuelta en el paso 2 para recuperar el nombre para mostrar del algoritmo.
ProviderFlags
La función ProviderFlags de Xenroll.dll especifica o recupera las marcas usadas al adquirir un identificador para un CSP.
La biblioteca de CertEnroll.dll no asigna esta función perfectamente, pero puede obtener información de propiedad enriquecida del objeto de inscripción y la clave privada. Para obtener más información, examine las propiedades expuestas por las interfaces IX509Enrollment y IX509PrivateKey .
ProviderNameWStr
La función ProviderNameWStr de Xenroll.dll especifica o recupera el nombre de un CSP.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar el nombre del proveedor:
- Llame a la propiedad Request en un objeto IX509Enrollment existente.
- Llame al método GetInnerRequest en la solicitud devuelta en el paso 1 para recuperar la solicitud más interna.
- Llame a QueryInterface en el objeto IX509CertificateRequest devuelto del paso 2 para convertir a un objeto IX509CertificateRequestPkcs10 .
- Llame a la propiedad PrivateKey en la solicitud PKCS #10.
- Llame a la propiedad ProviderName en el objeto IX509PrivateKey recuperado del paso 4.
ProviderType
La función ProviderType de Xenroll.dll especifica o recupera un valor entero que identifica el tipo del CSP.
Al usar CertEnroll.dll, puede realizar las siguientes acciones para recuperar el tipo de proveedor:
- Llame a la propiedad Request en un objeto IX509Enrollment existente.
- Llame al método GetInnerRequest en la solicitud devuelta en el paso 1 para recuperar la solicitud más interna.
- Llame a QueryInterface en el objeto IX509CertificateRequest devuelto del paso 2 para convertir a un objeto IX509CertificateRequestPkcs10 .
- Llame a la propiedad PrivateKey en la solicitud PKCS #10.
- Llame a la propiedad ProviderType en el objeto IX509PrivateKey recuperado del paso 4.
Temas relacionados