Função DrtCreateDerivedKey (drt.h)

Artigo
02/26/2024

A função DrtCreateDerivedKey cria uma chave que pode ser utilizada por DrtRegisterKey quando o DRT está usando um provedor de segurança de chave derivada.

Sintaxe

HRESULT DrtCreateDerivedKey(
  [in]  PCCERT_CONTEXT pLocalCert,
  [out] DRT_DATA       *pKey
);

Parâmetros

[in] pLocalCert

Ponteiro para o certificado que é a parte "local" da cadeia. A raiz dessa cadeia deve corresponder à raiz especificada por pRootCert em DrtCreateDerivedKeySecurityProvider. Esse certificado é usado para gerar uma chave que é usada para registrar e provar a "propriedade da chave" com o DRT.

[out] pKey

Ponteiro para a chave criada.

Retornar valor

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem:

Código de retorno	Descrição
E_INVALIDARG	pLocalCert é NULL. pKey é NULL. O membro pb na estrutura DRT_DATA é NULL. O membro cb na estrutura DRT_DATA não é igual a 32 bytes.
DRT_E_CAPABILITY_MISMATCH	Os algoritmos de segurança solicitados não estão disponíveis ( ou seja, BCRYPT_SHA256_ALGORITHM ou BCRYPT_AES_ALGORITHM). Falha na operação BCryptOpenAlgorithmProvider . O parâmetro dwProvType indica que o provedor de certificados não é capaz de AES.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	drt.h
Biblioteca	Drtprov.lib
DLL	Drt.dll

Confira também

DrtCreateDerivedKeySecurityProvider

DrtDeleteDerivedKeySecurityProvider

DrtRegisterKey

Compartilhar via