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 name="ksp-library-apis-open-key"></a>

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

## Parâmetros
<a name="ksp-library-apis-open-key-parameters"></a>

 `hProvider` [in]   
O identificador do KSP que contém a chave. Use [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md) 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 name="ksp-library-apis-open-key-return-value"></a>

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\$1SUCCESS  |  A operação foi concluída com êxito.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Um ou mais parâmetros não são válidos.  | 
|  NTE\$1FAIL  |  A operação não foi concluída.  | 
|  NTE\$1INVALID\$1HANDLE  |  O identificador em `hProvider` não é válido.  | 
|  NTE\$1BAD\$1KEYSET  |  O nome da chave fornecido não retornou um resultado exclusivo.  |