Partilhar via

Função DrtCreateDerivedKey (drt.h)

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

  • Last updated on