Compartilhar via


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

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll

Confira também

Funções Gerenciamento de Dados