Compartilhar via


Função CertSetEnhancedKeyUsage (wincrypt.h)

A função CertSetEnhancedKeyUsage define a propriedade EKU ( uso avançado de chave ) para o certificado. O uso dessa função substitui todas as EKUs associadas ao certificado. Para adicionar um único uso de EKU sem alterar os usos existentes, use CertAddEnhancedKeyUsageIdentifier. Para excluir um único uso de EKU, use CertRemoveEnhancedKeyUsageIdentifier.

Sintaxe

BOOL CertSetEnhancedKeyUsage(
  [in] PCCERT_CONTEXT     pCertContext,
  [in] PCERT_ENHKEY_USAGE pUsage
);

Parâmetros

[in] pCertContext

Um ponteiro para o CERT_CONTEXT do certificado especificado.

[in] pUsage

Ponteiro para uma estrutura de CERT_ENHKEY_USAGE (equivalente a uma estrutura CTL_USAGE ) que contém uma matriz de OIDs ( identificadores de objeto de EKU) a ser definida como propriedades estendidas do certificado.

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero (TRUE).

Se a função falhar, ela retornará zero (FALSE). Para obter informações de erro estendidas, chame GetLastError.

Requisitos

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

Confira também

CertGetEnhancedKeyUsage

Funções de uso de chave aprimoradas