View a markdown version of this page

NCryptOpenKey com o provedor de armazenamento de chaves (KSP) - AWS CloudHSM

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

NCryptOpenKey com o provedor de armazenamento de chaves (KSP)

A função NCryptOpenKey abre uma chave que existe no Provedor de Armazenamento de Chaves (KSP).

Parâmetros

hProvider [in]

O identificador do KSP que contém a chave. Use NCryptOpenStorageProvider para obter o identificador.

phKey [out]

Um ponteiro para uma variável NCRYPT_KEY_HANDLE que armazena o identificador da chave.

pszKeyName [in]

Um ponteiro para uma string Unicode terminada em nulo contendo o nome da chave.

dwLegacyKeySpec [in, unused]

AWS CloudHSM O Key Storage Provider (KSP) não usa esse parâmetro.

dwFlags [in]

Sinalizadores que modificam o comportamento da função. Nenhum sinalizador está definido para essa função.

Valor de retorno

A função retorna um código de status para indicar êxito ou falha.

Os códigos de retorno comuns incluem:

Código de retorno Description

ERROR_SUCCESS

A operação foi concluída com êxito.

NTE_INVALID_PARAMETER

Um ou mais parâmetros não são válidos.

NTE_FAIL

A operação não foi concluída.

NTE_INVALID_HANDLE

O identificador em hProvider não é válido.

NTE_BAD_KEYSET

O nome da chave fornecido não retornou um resultado exclusivo.