CRYPTUI_WIZ_IMPORT_SRC_INFO 構造体 (cryptuiapi.h)

  • [アーティクル]

[ CRYPTUI_WIZ_IMPORT_SRC_INFO 構造は、[要件] セクションで指定したオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

CRYPTUI_WIZ_IMPORT_SRC_INFO構造体には、CryptUIWizImport 関数にインポートするサブジェクトが含まれています。 サブジェクトには、 証明書、 証明書信頼リスト (CTL)、または 証明書失効リスト (CRL) を指定できます。

構文

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;

メンバー

dwSize

この構造体のサイズ (バイト単位)。

dwSubjectChoice

インポートする対象の種類を示します。 このメンバーには、次のいずれかの値を指定できます。

値 意味
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE
 pwszFileName メンバーで参照されているファイルに格納されている証明書をインポートします。
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT
 pCertContext メンバーで参照されている証明書をインポートします。
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT
 pCTLContext メンバーで参照されている CTL をインポートします。
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT
 pCRLContext メンバーで参照されている CRL をインポートします。
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE
 hCertStore メンバーで参照されている証明書ストアをインポートします。

pwszFileName

インポートする証明書を含むファイルのパスとファイル名を含む、null で終わる Unicode 文字列へのポインター。 このメンバーは、 dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_FILEが含まれている場合に使用されます。

pCertContext

インポートする証明書を含む CERT_CONTEXT 構造体へのポインター。 このメンバーは、 dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXTが含まれている場合に使用されます。

pCTLContext

インポートする CTL を含む CTL_CONTEXT 構造体へのポインター。 このメンバーは、 dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXTが含まれている場合に使用されます。

pCRLContext

インポートする CRL を含む CRL_CONTEXT 構造体へのポインター。 このメンバーは、 dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXTが含まれている場合に使用されます。

hCertStore

インポートする証明書ストアへのハンドル。 このメンバーは、 dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STOREが含まれている場合に使用されます。

dwFlags

インポート操作を変更するフラグが含まれています。 pwszFileName に個人情報交換 (PFX) BLOB が含まれている場合は、このメンバーが必要です。 それ以外の場合、このメンバーは無視されます。 このメンバーには、0 または次の値の 1 つ以上の組み合わせを指定できます。

値 意味
CRYPT_EXPORTABLE
 インポートされたキーはエクスポート可能とマークされます。 このフラグを使用しない場合、キー ハンドルを使用して CryptExportKey 関数を呼び出すと失敗します。
CRYPT_USER_PROTECTED
 特定のアクションでこのキーを使用しようとすると、ダイアログ ボックスまたはその他の方法でユーザーに通知されます。 正確な動作は、使用されている 暗号化サービス プロバイダー (CSP) によって指定されます。

インターネット エクスプローラー 4.0 より前では、Microsoft CSP はこのフラグを無視しました。 Internet エクスプローラー 4.0 以降では、Microsoft CSP はこのフラグをサポートしています。

プロバイダー コンテキストが CRYPT_SILENT フラグを設定して開かれた場合、このフラグを使用するとエラーが発生し、最後のエラーは NTE_SILENT_CONTEXT に設定されます。
CRYPT_MACHINE_KEYSET
 秘密キーは、現在のユーザーの下ではなく、ローカル コンピューターの下に格納されます。
CRYPT_USER_KEYSET
 秘密キーは、PFX BLOB でローカル コンピューターの下に移動する必要があると指定されている場合でも、ローカル コンピューターの下ではなく、現在のユーザーの下に格納されます。

pwszPassword

秘密キーへのアクセスに使用されるパスワードを含む null で終わる Unicode 文字列へのポインター。 pwszFileName に PFX BLOB が含まれている場合は、パスワードが必要です。 パスワードが不要な場合は、変数に空の文字列を指定できます。 このメンバーを NULL にすることはできません。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header cryptuiapi.h

関連項目

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport