Função CertGetIntendedKeyUsage (wincrypt.h)

A função CertGetIntendedKeyUsage adquire os bytes de uso de chave pretendidos de um certificado. O uso da chave pretendida pode estar na extensão szOID_KEY_USAGE ("2.5.29.15") ou szOID_KEY_ATTRIBUTES ("2.5.29.2").

Sintaxe

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

Parâmetros

[in] dwCertEncodingType

Especifica o tipo de codificação usado. É sempre aceitável especificar os tipos de codificação de certificado e mensagem combinando-os com uma operação OR bit a bit, conforme mostrado no exemplo a seguir:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Tipos de codificação definidos no momento são:

• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING

[in] pCertInfo

Um ponteiro para CERT_INFO estrutura do certificado especificado.

[out] pbKeyUsage

Um ponteiro para um buffer para receber o uso de chave pretendido. A lista a seguir mostra valores definidos no momento. Eles podem ser combinados usando operações 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

O tamanho, em bytes, do buffer apontado por pbKeyUsage. Atualmente, o uso de chave pretendido ocupa 1 ou 2 bytes de dados.

Retornar valor

Se o certificado não tiver nenhum bytes de uso de chave pretendidos, FALSE será retornado e pbKeyUsage será zerado. Caso contrário, TRUE será retornado e até o número cbKeyUsage de bytes será copiado para pbKeyUsage. Todos os bytes restantes não copiados são zero.

GetLastError retornará zero se nenhuma das extensões necessárias for encontrada.

Se a função falhar, GetLastError poderá retornar um erro de codificação/decodificação de ASN.1 (Abstract Syntax Notation One ). Para obter informações sobre esses erros, consulte Codificação/Decodificação de Valores Retornados do ASN.1.

Requisitos

Confira também

Funções Gerenciamento de Dados