Função CryptGetUserKey (wincrypt.h)
Sintaxe
BOOL CryptGetUserKey(
[in] HCRYPTPROV hProv,
[in] DWORD dwKeySpec,
[out] HCRYPTKEY *phUserKey
);
Parâmetros
[in] hProv
Identificador HCRYPTPROV de um provedor de serviços criptográficos (CSP) criado por uma chamada para CryptAcquireContext.
[in] dwKeySpec
Identifica a chave privada a ser usada no contêiner de chaves. Pode ser AT_KEYEXCHANGE ou AT_SIGNATURE.
Além disso, alguns provedores permitem o acesso a outras chaves específicas do usuário por meio dessa função. Para obter detalhes, consulte a documentação sobre o provedor específico.
[out] phUserKey
Um ponteiro para o identificador HCRYPTKEY das chaves recuperadas. Quando terminar de usar a chave, exclua o identificador chamando a função CryptDestroyKey .
Retornar valor
Se a função for bem-sucedida, o valor retornado será diferente de zero (TRUE).
Se a função falhar, o valor retornado será zero (FALSE). Para obter informações de erro estendidas, chame GetLastError.
Os códigos de erro precedidos por "NTE" são gerados pelo CSP específico que está sendo usado. Alguns códigos de erro possíveis seguem.
Código de retorno | Descrição |
---|---|
|
Um dos parâmetros especifica um identificador que não é válido. |
|
Um dos parâmetros contém um valor que não é válido. Geralmente, esse é um ponteiro que não é válido. |
|
O parâmetro dwKeySpec contém um valor que não é válido. |
|
O parâmetro hProv não contém um identificador de contexto válido. |
|
A chave solicitada pelo parâmetro dwKeySpec não existe. |
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | wincrypt.h |
Biblioteca | Advapi32.lib |
DLL | Advapi32.dll |