estrutura CRYPTUI_WIZ_IMPORT_SRC_INFO (cryptuiapi.h)

Artigo
08/22/2023

[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.

Valor	Significado
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE	Importe o certificado armazenado no arquivo referenciado no membro pwszFileName .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT	Importe o certificado referenciado no membro pCertContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT	Importe a CTL referenciada no membro pCTLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT	Importe a CRL referenciada no membro pCRLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE	Importe o repositório de certificados referenciado no membro hCertStore .

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
CRYPT_EXPORTABLE	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.
CRYPT_USER_PROTECTED	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.
CRYPT_MACHINE_KEYSET	As chaves privadas são armazenadas no computador local e não no usuário atual.
CRYPT_USER_KEYSET	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

Confira também

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport