Função NCryptSecretAgreement (ncrypt.h)

A função NCryptSecretAgreement cria um valor de contrato secreto de uma chave pública e privada.

Sintaxe

SECURITY_STATUS NCryptSecretAgreement(
  [in]  NCRYPT_KEY_HANDLE    hPrivKey,
  [in]  NCRYPT_KEY_HANDLE    hPubKey,
  [out] NCRYPT_SECRET_HANDLE *phAgreedSecret,
  [in]  DWORD                dwFlags
);

Parâmetros

[in] hPrivKey

O identificador da chave privada a ser usada para criar o valor do contrato secreto. Essa chave e a chave hPubKey devem vir do mesmo provedor de armazenamento de chaves.

[in] hPubKey

O identificador da chave pública a ser usada para criar o valor do contrato secreto. Essa chave e a chave hPrivKey devem vir do mesmo provedor de armazenamento de chaves.

[out] phAgreedSecret

Um ponteiro para uma variável NCRYPT_SECRET_HANDLE que recebe um identificador que representa o valor do contrato secreto. Quando esse identificador não for mais necessário, libere-o passando-o para a função NCryptFreeObject .

[in] dwFlags

Sinalizadores que modificam o comportamento da função. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir. O conjunto de sinalizadores válidos é específico para cada provedor de armazenamento de chaves. O sinalizador a seguir se aplica a todos os provedores.

Retornar valor

Retorna um código status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Comentários

Um serviço não deve chamar essa função de sua função StartService. Se um serviço chamar essa função de sua função StartService, um deadlock poderá ocorrer e o serviço poderá parar de responder.

Requisitos

Confira também

NCryptFreeObject