Função DrtCreateDerivedKeySecurityProvider (drt.h)

  • Artigo

A função DrtCreateDerivedKeySecurityProvider cria o provedor de segurança de chave derivada para uma Tabela de Roteamento Distribuído.

Sintaxe

HRESULT DrtCreateDerivedKeySecurityProvider(
  [in]  PCCERT_CONTEXT        pRootCert,
  [out] PCCERT_CONTEXT        pLocalCert,
        DRT_SECURITY_PROVIDER **ppSecurityProvider
);

Parâmetros

[in] pRootCert

Ponteiro para o certificado que é a parte "raiz" da cadeia. Isso é usado para garantir que as chaves derivadas da mesma cadeia possam ser verificadas.

[out] pLocalCert

Ponteiro para o módulo DRT_SECURITY_PROVIDER a ser incluído na estrutura DRT_SETTINGS .

ppSecurityProvider

Recebe um ponteiro para o provedor de segurança criado.

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
 pRootCert é NULL.
E_OUTOFMEMORY
 O sistema não pôde alocar memória para o provedor de segurança.
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.
DRT_E_INVALID_CERT_CHAIN
 Nenhum repositório de certificados anexado ou há um erro na cadeia de certificados.

Comentários

O provedor de segurança criado por essa função é específico para o DRT para o qual foi criado. Ele não pode ser compartilhado por várias instâncias drt.

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

DRT_REGISTRATION

DRT_SETTINGS

DrtCreateDerivedKey

DrtDeleteDerivedKeySecurityProvider