NCryptEnumKeys com Provedor de armazenamento de chaves (KSP)
A função NCryptEnumKeys lista as chaves armazenadas no Provedor de armazenamento de chaves (KSP).
Parâmetros
-
hProvider[in] -
O identificador do provedor de armazenamento de chaves. Use NCryptOpenStorageProvider para obter esse identificador.
-
pszScope[in, unused] -
Defina este parâmetro como NULL.
-
ppKeyName[out] -
Um endereço de ponteiro para uma estrutura
NCryptKeyNameque armazena o nome da chave. Para liberar essa memória após o uso, chameNCryptFreeBuffer. ppEnumState[in, out]-
Um endereço de ponteiro VOID que rastreia o progresso da enumeração. O provedor de armazenamento de chaves usa essas informações internamente para gerenciar a sequência de enumeração. Para iniciar uma nova enumeração desde o início, defina esse ponteiro como NULL.
Para liberar essa memória após concluir a enumeração, passe esse ponteiro para
NCryptFreeBuffer. dwFlags[in]-
Sinalizadores para modificar o comportamento da função. A função não tem sinalizadores.
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 | Descrição |
|---|---|
|
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_NO_MORE_ITEMS |
A enumeração listou todas as chaves disponíveis. |
