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_HANDLEque 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 |
|
NTE_BAD_KEYSET |
O nome da chave fornecido não retornou um resultado exclusivo. |