estructura CRYPTUI_WIZ_IMPORT_SRC_INFO (cryptuiapi.h)

[La estructura CRYPTUI_WIZ_IMPORT_SRC_INFO está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La estructura CRYPTUI_WIZ_IMPORT_SRC_INFO contiene el asunto que se va a importar en la función CryptUIWizImport . El sujeto puede ser un certificado, una lista de confianza de certificados (CTL) o una lista de revocación de certificados (CRL).

Sintaxis

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;

Miembros

dwSize

Tamaño, en bytes, de esta estructura.

dwSubjectChoice

Indica el tipo de asunto que se va a importar. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE	Importe el certificado almacenado en el archivo al que se hace referencia en el miembro pwszFileName .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT	Importe el certificado al que se hace referencia en el miembro pCertContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT	Importe el CTL al que se hace referencia en el miembro pCTLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT	Importe la CRL a la que se hace referencia en el miembro pCRLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE	Importe el almacén de certificados al que se hace referencia en el miembro hCertStore .

pwszFileName

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso y el nombre de archivo del archivo que contiene el certificado que se va a importar. Este miembro se usa si el miembro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_FILE.

pCertContext

Puntero a la estructura CERT_CONTEXT que contiene el certificado que se va a importar. Este miembro se usa si el miembro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT.

pCTLContext

Puntero a la estructura CTL_CONTEXT que contiene el CTL que se va a importar. Este miembro se usa si el miembro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT.

pCRLContext

Puntero a la estructura CRL_CONTEXT que contiene la CRL que se va a importar. Este miembro se usa si el miembro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT.

hCertStore

Identificador del almacén de certificados que se va a importar. Este miembro se usa si el miembro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE.

dwFlags

Contiene marcas que modifican la operación de importación. Este miembro es necesario si pwszFileName contiene un BLOB de intercambio de información personal (PFX). De lo contrario, se omite este miembro. Este miembro puede ser cero o una combinación de uno o varios de los valores siguientes.

Valor	Significado
CRYPT_EXPORTABLE	Las claves importadas se marcan como exportables. Si no se usa esta marca, se produce un error en las llamadas a la función CryptExportKey con el identificador de clave.
CRYPT_USER_PROTECTED	El usuario debe recibir notificaciones por medio de un cuadro de diálogo o de alguna otra manera cuando determinadas acciones intentan usar esta clave. El comportamiento preciso lo especifica el proveedor de servicios criptográficos (CSP) que se está usando. Antes de Internet Explorer 4.0, los CSP de Microsoft ignoraban esta marca. A partir de Internet Explorer 4.0, los CSP de Microsoft admiten esta marca. Si el contexto del proveedor se abrió con la marca CRYPT_SILENT establecida, el uso de esta marca produce un error y el último error se establece en NTE_SILENT_CONTEXT.
CRYPT_MACHINE_KEYSET	Las claves privadas se almacenan en el equipo local y no en el usuario actual.
CRYPT_USER_KEYSET	Las claves privadas se almacenan en el usuario actual y no en el equipo local, incluso si el BLOB PFX especifica que deben ir en el equipo local.

pwszPassword

Puntero a una cadena Unicode terminada en null que contiene la contraseña usada para acceder a la clave privada. Se requiere una contraseña si pwszFileName contiene un BLOB PFX. Si no se requiere una contraseña, la variable puede ser una cadena vacía. Este miembro no puede ser NULL.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	cryptuiapi.h

Consulte también

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport