UserCertificateEnrollmentManager.ImportPfxDataAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
ImportPfxDataAsync(String, String, PfxImportParameters) |
지정된 가져오기 매개 변수를 사용하여 PFX(개인 정보 교환) 메시지에서 인증서를 비동기적으로 가져옵니다. |
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String) |
PFX(개인 정보 교환) 메시지에서 사용자 인증서를 비동기적으로 가져옵니다. |
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String) |
지정된 키 스토리지 공급자를 사용하여 PFX(개인 정보 교환) 메시지에서 인증서를 비동기적으로 가져옵니다. |
ImportPfxDataAsync(String, String, PfxImportParameters)
지정된 가져오기 매개 변수를 사용하여 PFX(개인 정보 교환) 메시지에서 인증서를 비동기적으로 가져옵니다.
public:
virtual IAsyncAction ^ ImportPfxDataAsync(Platform::String ^ pfxData, Platform::String ^ password, PfxImportParameters ^ pfxImportParameters) = ImportPfxDataAsync;
/// [Windows.Foundation.Metadata.Overload("ImportPfxDataToKspWithParametersAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction ImportPfxDataAsync(winrt::hstring const& pfxData, winrt::hstring const& password, PfxImportParameters const& pfxImportParameters);
[Windows.Foundation.Metadata.Overload("ImportPfxDataToKspWithParametersAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction ImportPfxDataAsync(string pfxData, string password, PfxImportParameters pfxImportParameters);
function importPfxDataAsync(pfxData, password, pfxImportParameters)
Public Function ImportPfxDataAsync (pfxData As String, password As String, pfxImportParameters As PfxImportParameters) As IAsyncAction
매개 변수
- pfxData
-
String
Platform::String
winrt::hstring
Base64로 인코딩된 PFX 메시지입니다.
- password
-
String
Platform::String
winrt::hstring
PFX 패킷의 암호를 해독하고 확인하는 데 사용되는 암호입니다. 암호는 패킷을 암호화하는 데 사용된 암호와 정확히 동일해야 합니다.
- pfxImportParameters
- PfxImportParameters
가져오기 매개 변수입니다.
반환
이 메서드는 값을 반환하지 않습니다.
- 특성
추가 정보
- ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)
- ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)
적용 대상
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)
PFX(개인 정보 교환) 메시지에서 사용자 인증서를 비동기적으로 가져옵니다.
public:
virtual IAsyncAction ^ ImportPfxDataAsync(Platform::String ^ pfxData, Platform::String ^ password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, Platform::String ^ friendlyName) = ImportPfxDataAsync;
/// [Windows.Foundation.Metadata.Overload("ImportPfxDataAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction ImportPfxDataAsync(winrt::hstring const& pfxData, winrt::hstring const& password, ExportOption const& exportable, KeyProtectionLevel const& keyProtectionLevel, InstallOptions const& installOption, winrt::hstring const& friendlyName);
[Windows.Foundation.Metadata.Overload("ImportPfxDataAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction ImportPfxDataAsync(string pfxData, string password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, string friendlyName);
function importPfxDataAsync(pfxData, password, exportable, keyProtectionLevel, installOption, friendlyName)
Public Function ImportPfxDataAsync (pfxData As String, password As String, exportable As ExportOption, keyProtectionLevel As KeyProtectionLevel, installOption As InstallOptions, friendlyName As String) As IAsyncAction
매개 변수
- pfxData
-
String
Platform::String
winrt::hstring
Base64로 인코딩된 PFX 메시지입니다.
- password
-
String
Platform::String
winrt::hstring
PFX 패킷의 암호를 해독하고 확인하는 데 사용되는 암호입니다. 암호는 패킷을 암호화하는 데 사용된 암호와 정확히 동일해야 합니다.
- exportable
- ExportOption
키를 내보낼 수 있는지 여부를 지정하는 ExportOption 열거형의 값입니다.
- keyProtectionLevel
- KeyProtectionLevel
키 보호의 강도를 지정하는 KeyProtectionLevel 열거형의 값입니다. 기본값은 NoConsent입니다.
- installOption
- InstallOptions
인증서 설치 옵션을 지정하는 InstallOptions 열거형 값입니다.
- friendlyName
-
String
Platform::String
winrt::hstring
등록된 인증서의 표시 이름입니다. 이 값은 PFX 메시지 내의 FriendlyName 속성을 덮어씁니다.
반환
이 메서드는 값을 반환하지 않습니다.
- 특성
예제
다음 코드는 pfx 기반 인증서를 사용자의 "내" 저장소로 가져오고 디바이스 TPM(신뢰할 수 있는 플랫폼 모듈)을 사용하여 인증서의 프라이빗 키를 보호합니다. 앱에는 sharedUserCertificates
PFX 파일을 가져오거나 사용자의 "MY" 인증서 저장소에서 인증서를 사용하는 기능이 필요합니다.
CertificateEnrollmentManager.UserCertificateEnrollmentManager.ImportPfxDataAsync(
pfxData,
password,
ExportOption.NotExportable,
KeyProtectionLevel.NoConsent,
InstallOptions.DeleteExpired,
strFriendlyName,
KeyStorageProviderNames.PlatformKeyStorageProvider);
추가 정보
- ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)
적용 대상
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)
지정된 키 스토리지 공급자를 사용하여 PFX(개인 정보 교환) 메시지에서 인증서를 비동기적으로 가져옵니다.
public:
virtual IAsyncAction ^ ImportPfxDataAsync(Platform::String ^ pfxData, Platform::String ^ password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, Platform::String ^ friendlyName, Platform::String ^ keyStorageProvider) = ImportPfxDataAsync;
/// [Windows.Foundation.Metadata.Overload("ImportPfxDataToKspAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction ImportPfxDataAsync(winrt::hstring const& pfxData, winrt::hstring const& password, ExportOption const& exportable, KeyProtectionLevel const& keyProtectionLevel, InstallOptions const& installOption, winrt::hstring const& friendlyName, winrt::hstring const& keyStorageProvider);
[Windows.Foundation.Metadata.Overload("ImportPfxDataToKspAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction ImportPfxDataAsync(string pfxData, string password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, string friendlyName, string keyStorageProvider);
function importPfxDataAsync(pfxData, password, exportable, keyProtectionLevel, installOption, friendlyName, keyStorageProvider)
Public Function ImportPfxDataAsync (pfxData As String, password As String, exportable As ExportOption, keyProtectionLevel As KeyProtectionLevel, installOption As InstallOptions, friendlyName As String, keyStorageProvider As String) As IAsyncAction
매개 변수
- pfxData
-
String
Platform::String
winrt::hstring
Base64로 인코딩된 PFX 메시지입니다.
- password
-
String
Platform::String
winrt::hstring
PFX 패킷의 암호를 해독하고 확인하는 데 사용되는 암호입니다. 암호는 패킷을 암호화하는 데 사용된 암호와 정확히 동일해야 합니다.
- exportable
- ExportOption
키를 내보낼 수 있는지 여부를 지정하는 ExportOption 열거형의 값입니다.
- keyProtectionLevel
- KeyProtectionLevel
키 보호의 강도를 지정하는 KeyProtectionLevel 열거형의 값입니다. 기본값은 NoConsent입니다.
- installOption
- InstallOptions
인증서 설치 옵션을 지정하는 InstallOptions 열거형 값입니다.
- friendlyName
-
String
Platform::String
winrt::hstring
등록된 인증서의 표시 이름입니다. 이 값은 PFX 메시지 내의 FriendlyName 속성을 덮어씁니다.
- keyStorageProvider
-
String
Platform::String
winrt::hstring
인증서를 가져올 때 사용할 키 스토리지 공급자의 이름입니다.
반환
이 메서드는 값을 반환하지 않습니다.
- 특성
예제
다음 코드는 pfx 기반 인증서를 사용자의 "내" 저장소로 가져오고 디바이스 TPM(신뢰할 수 있는 플랫폼 모듈)을 사용하여 인증서의 프라이빗 키를 보호합니다. 앱에는 sharedUserCertificates
PFX 파일을 가져오거나 사용자의 "MY" 인증서 저장소에서 인증서를 사용하는 기능이 필요합니다.
CertificateEnrollmentManager.UserCertificateEnrollmentManager.ImportPfxDataAsync(
pfxData,
password,
ExportOption.NotExportable,
KeyProtectionLevel.NoConsent,
InstallOptions.DeleteExpired,
strFriendlyName,
KeyStorageProviderNames.PlatformKeyStorageProvider);