Função CryptUIWizImport (cryptuiapi.h)
A função importa um certificado, uma CTL ( lista de certificados confiáveis ), uma CRL ( lista de certificados revogados ) ou um repositório de certificados para um repositório de certificados. A importação pode ser executada com ou sem interação do usuário.
Sintaxe
BOOL CryptUIWizImport(
[in] DWORD dwFlags,
[in] HWND hwndParent,
[in] LPCWSTR pwszWizardTitle,
[in] PCCRYPTUI_WIZ_IMPORT_SRC_INFO pImportSrc,
[in] HCERTSTORE hDestCertStore
);
Parâmetros
[in] dwFlags
Contém sinalizadores que modificam o comportamento da função. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
Valor | Significado |
---|---|
|
Essa função executará a importação com base nas informações na estrutura CRYPTUI_WIZ_IMPORT_SRC_INFO apontada por pImportSrc no repositório especificado por hDestCertStore sem exibir nenhuma interface do usuário. Se esse sinalizador não for especificado, essa função exibirá um assistente para orientar o usuário durante o processo de importação.
Começando com Windows 8 e Windows Server 2012, se você definir esse sinalizador e estiver importando um certificado de um BLOB PFX protegido para uma entidade de segurança do AD (Active Directory), e o usuário atual, como parte dessa entidade de segurança, tiver permissão para descriptografar a senha inserida no pacote PFX, a importação terá êxito sem exigir que uma senha seja definida no CRYPTUI_WIZ_IMPORT_SRC_INFO Estrutura. Para obter mais informações sobre como proteger o PFX para uma entidade de segurança do AD, consulte o parâmetro pvPara e o sinalizador PKCS12_PROTECT_TO_DOMAIN_SIDS da função PFXExportCertStoreEx . |
|
Suprimir todas as interfaces do usuário geradas por CSPs ( provedores de serviços criptográficos ). Essa opção pode ser substituída pela opção CRYPTUI_WIZ_NO_UI_EXCEPT_CSP . |
|
Suprima todas as interfaces do usuário, exceto aquelas geradas por CSPs. Essa opção substitui a opção CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS . |
|
Permitir que os certificados sejam importados. |
|
Permitir que as CRLs sejam importadas. |
|
Permitir que as CTLs sejam importadas. |
|
Não permita que o usuário altere o repositório de certificados de destino representado pelo parâmetro hDestCertStore . |
|
Importe o objeto para o repositório de certificados do computador local. Isso se aplica somente às importações do PFX (Troca de Informações Pessoais). |
|
Importe o objeto para o repositório de certificados do usuário atual. Isso se aplica somente às importações PFX. |
|
Importe o objeto para um repositório de certificados remoto. Defina esse sinalizador se o parâmetro hDestCertStore representar um repositório de certificados remoto. |
[in] hwndParent
O identificador da janela a ser usada como o pai da caixa de diálogo que essa função cria. Esse parâmetro será ignorado se o sinalizador CRYPTUI_WIZ_NO_UI estiver definido em dwFlags.
[in] pwszWizardTitle
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o título a ser usado na caixa de diálogo que essa função cria. Esse parâmetro será ignorado se o sinalizador CRYPTUI_WIZ_NO_UI estiver definido em dwFlags.
[in] pImportSrc
Um ponteiro para uma estrutura CRYPTUI_WIZ_IMPORT_SRC_INFO que contém informações sobre o objeto a ser importado. Esse parâmetro será necessário se CRYPTUI_WIZ_NO_UI estiver definido em dwFlags e for opcional caso contrário.
[in] hDestCertStore
Um identificador para o repositório de certificados para o qual importar. Se esse parâmetro for NULL e o sinalizador CRYPTUI_WIZ_NO_UI não estiver definido em dwFlags, o assistente solicitará que o usuário selecione um repositório de certificados.
Retornar valor
Se a função for bem-sucedida, a função retornará diferente de zero.
Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame a função GetLastError .
Comentários
Se nenhum dos três sinalizadores a seguir estiver definido em dwFlags, a importação de qualquer tipo de conteúdo será permitida:
- CRYPTUI_WIZ_IMPORT_ALLOW_CERT
- CRYPTUI_WIZ_IMPORT_ALLOW_CRL
- CRYPTUI_WIZ_IMPORT_ALLOW_CTL
- A chave privada no BLOB PFX será forçada a ser importada para o repositório de usuários atual.
- E se CRYPTUI_WIZ_NO_UI não estiver definido, o assistente solicitará que o usuário selecione um repositório de certificados entre os repositórios de certificados do usuário atual.
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 | cryptuiapi.h |
Biblioteca | Cryptui.lib |
DLL | Cryptui.dll |