estrutura CRYPTUI_WIZ_IMPORT_SRC_INFO (cryptuiapi.h)
[A estrutura CRYPTUI_WIZ_IMPORT_SRC_INFO está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]
A estrutura CRYPTUI_WIZ_IMPORT_SRC_INFO contém o assunto a ser importado para a função CryptUIWizImport . A entidade pode ser um certificado, uma CTL ( lista de confiança de certificado ) ou uma CRL (lista de certificados revogados ).
Sintaxe
typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO {
DWORD dwSize;
DWORD dwSubjectChoice;
union {
LPCWSTR pwszFileName;
PCCERT_CONTEXT pCertContext;
PCCTL_CONTEXT pCTLContext;
PCCRL_CONTEXT pCRLContext;
HCERTSTORE hCertStore;
};
DWORD dwFlags;
LPCWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;
Membros
dwSize
O tamanho, em bytes, dessa estrutura.
dwSubjectChoice
Indica o tipo de sujeito à importação. Esse membro pode ser um dos valores a seguir.
pwszFileName
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho e o nome do arquivo que contém o certificado a ser importado. Esse membro será usado se o membro dwSubjectChoicecontiver CRYPTUI_WIZ_IMPORT_SUBJECT_FILE.
pCertContext
Um ponteiro para a estrutura CERT_CONTEXT que contém o certificado a ser importado. Esse membro será usado se o membro dwSubjectChoicecontiver CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT.
pCTLContext
Um ponteiro para a estrutura CTL_CONTEXT que contém a CTL a ser importada. Esse membro será usado se o membro dwSubjectChoice contiver CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT.
pCRLContext
Um ponteiro para a estrutura CRL_CONTEXT que contém a CRL a ser importada. Esse membro será usado se o membro dwSubjectChoice contiver CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT.
hCertStore
Um identificador para o repositório de certificados a ser importado. Esse membro será usado se o membro dwSubjectChoice contiver CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE.
dwFlags
Contém sinalizadores que modificam a operação de importação. Esse membro será necessário se pwszFileName contiver um BLOB PFX (Troca de Informações Pessoais). Caso contrário, esse membro será ignorado. Esse membro pode ser zero ou uma combinação de um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
|
As chaves importadas são marcadas como exportáveis. Se esse sinalizador não for usado, as chamadas para a função CryptExportKey com o identificador de chave falharão. |
|
O usuário deve ser notificado por meio de uma caixa de diálogo ou de alguma outra maneira quando determinadas ações estão tentando usar essa chave. O comportamento preciso é especificado pelo CSP ( provedor de serviços criptográficos ) que está sendo usado.
Antes do Internet Explorer 4.0, os CSPs da Microsoft ignoravam esse sinalizador. A partir do Internet Explorer 4.0, os CSPs da Microsoft dão suporte a esse sinalizador. Se o contexto do provedor foi aberto com o sinalizador CRYPT_SILENT definido, usar esse sinalizador causará uma falha e o último erro será definido como NTE_SILENT_CONTEXT. |
|
As chaves privadas são armazenadas no computador local e não no usuário atual. |
|
As chaves privadas são armazenadas no usuário atual e não no computador local, mesmo que o BLOB PFX especifique que elas devem ir para o computador local. |
pwszPassword
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a senha usada para acessar a chave privada. Uma senha será necessária se pwszFileName contiver um BLOB PFX. Se uma senha não for necessária, a variável poderá ser uma cadeia de caracteres vazia. Esse membro não pode ser NULL.
Requisitos
| 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] |
| Cabeçalho | cryptuiapi.h |