Función CertGetIntendedKeyUsage (wincrypt.h)

La función CertGetIntendedKeyUsage adquiere los bytes de uso de clave previstos de un certificado. El uso de clave previsto puede estar en la extensión szOID_KEY_USAGE ("2.5.29.15") o szOID_KEY_ATTRIBUTES ("2.5.29.2").

Sintaxis

BOOL CertGetIntendedKeyUsage(
  [in]  DWORD      dwCertEncodingType,
  [in]  PCERT_INFO pCertInfo,
  [out] BYTE       *pbKeyUsage,
  [in]  DWORD      cbKeyUsage
);

Parámetros

[in] dwCertEncodingType

Especifica el tipo de codificación usado. Siempre es aceptable especificar los tipos de codificación de certificados y mensajes al combinarlos con una operación OR bit a bit, como se muestra en el ejemplo siguiente:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING tipos de codificación definidos actualmente son:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pCertInfo

Puntero a CERT_INFO estructura del certificado especificado.

[out] pbKeyUsage

Puntero a un búfer para recibir el uso de clave previsto. En la lista siguiente se muestran los valores definidos actualmente. Estos se pueden combinar mediante operaciones OR bit a bit.

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_DIGITAL_SIGNATURE_KEY_USAGE
  • CERT_KEY_AGREEMENT_KEY_USAGE
  • CERT_KEY_CERT_SIGN_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE
  • CERT_NON_REPUDIATION_KEY_USAGE
  • CERT_OFFLINE_CRL_SIGN_KEY_USAGE

[in] cbKeyUsage

Tamaño, en bytes, del búfer al que apunta pbKeyUsage. Actualmente, el uso de clave previsto ocupa 1 o 2 bytes de datos.

Valor devuelto

Si el certificado no tiene ningún bytes de uso de clave previsto, se devuelve FALSE y pbKeyUsage se cero. De lo contrario, se devuelve TRUE y hasta cbKeyUsage número de bytes se copian en pbKeyUsage. Los bytes restantes que no se copian son ceros.

GetLastError devuelve cero si no se encuentra ninguna de las extensiones necesarias.

Si se produce un error en la función, GetLastError puede devolver un error de codificación y descodificación de sintaxis abstracta Uno (ASN.1). Para obtener información sobre estos errores, vea Valores devueltos de codificación/descodificación de ASN.1.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincrypt.h
Library Crypt32.lib
Archivo DLL Crypt32.dll

Consulte también

Funciones de Administración de datos