CertificateEnrollmentManager.ImportPfxDataAsync Method

Reference

Definition

Namespace:: Windows.Security.Cryptography.Certificates

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

ImportPfxDataAsync(String, String, PfxImportParameters)	Asynchronously imports a certificate from a Personal Information Exchange (PFX) message using import parameters.
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)	Asynchronously imports a certificate from a Personal Information Exchange (PFX) message.
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)	Asynchronously imports a certificate from a Personal Information Exchange (PFX) message using the specified key storage provider.

ImportPfxDataAsync(String, String, PfxImportParameters)

Edit

Asynchronously imports a certificate from a Personal Information Exchange (PFX) message using import parameters.

public:
 static IAsyncAction ^ ImportPfxDataAsync(Platform::String ^ pfxData, Platform::String ^ password, PfxImportParameters ^ pfxImportParameters);

/// [Windows.Foundation.Metadata.Overload("ImportPfxDataToKspWithParametersAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncAction ImportPfxDataAsync(winrt::hstring const& pfxData, winrt::hstring const& password, PfxImportParameters const& pfxImportParameters);

[Windows.Foundation.Metadata.Overload("ImportPfxDataToKspWithParametersAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncAction ImportPfxDataAsync(string pfxData, string password, PfxImportParameters pfxImportParameters);

function importPfxDataAsync(pfxData, password, pfxImportParameters)

Public Shared Function ImportPfxDataAsync (pfxData As String, password As String, pfxImportParameters As PfxImportParameters) As IAsyncAction

Parameters

pfxData: String
Platform::String

winrt::hstring

Base64-encoded PFX message.

password: String
Platform::String

winrt::hstring

The password used to decrypt and verify the PFX packet. The password must be exactly the same as the password that was used to encrypt the packet.

pfxImportParameters: PfxImportParameters

The PFX import parameters.

Returns

IAsyncAction

This method does not return a value.

Attributes: OverloadAttribute RemoteAsyncAttribute

Applies to

ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)

Edit

Asynchronously imports a certificate from a Personal Information Exchange (PFX) message.

public:
 static IAsyncAction ^ ImportPfxDataAsync(Platform::String ^ pfxData, Platform::String ^ password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, Platform::String ^ friendlyName);

/// [Windows.Foundation.Metadata.Overload("ImportPfxDataAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static 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 static IAsyncAction ImportPfxDataAsync(string pfxData, string password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, string friendlyName);

function importPfxDataAsync(pfxData, password, exportable, keyProtectionLevel, installOption, friendlyName)

Public Shared Function ImportPfxDataAsync (pfxData As String, password As String, exportable As ExportOption, keyProtectionLevel As KeyProtectionLevel, installOption As InstallOptions, friendlyName As String) As IAsyncAction

Parameters

pfxData: String
Platform::String

winrt::hstring

Base64-encoded PFX message.

password: String
Platform::String

winrt::hstring

The password used to decrypt and verify the PFX packet. The password must be exactly the same as the password that was used to encrypt the packet.

exportable: ExportOption

A value of the ExportOption enumeration that specifies whether the key can be exported.

keyProtectionLevel: KeyProtectionLevel

A value of the KeyProtectionLevel enumeration that specifies the strength of the key protection. The default is NoConsent.

installOption: InstallOptions

An InstallOptions enumeration value that specifies the certificate installation option.

friendlyName: String
Platform::String

winrt::hstring

The display name of the enrolled certificate. This value overwrites the FriendlyName property inside the PFX message.

Returns

IAsyncAction

This method does not return a value.

Attributes: OverloadAttribute RemoteAsyncAttribute

Remarks

This method imports the certificate chain into the app container.

To import an issued certificate, it is not necessary for the certificate request to have been generated on the importing computer.
The certificates included in the response need not be chained to trusted root certificates on the importing computer.
The certificate is installed in the app container MY store.
Certification authority and Root certificates are installed in the app container intermediate certification authority store.
The key container name and key specification for the imported certificate are determined as described in the Remarks section of PFXImportCertStore with the exception that if AttributeId 1.3.6.1.4.1.311.17.1 is not present, MS_KEY_STORAGE_PROVIDER is always used as the provider name.

Applies to

ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)

Edit

Asynchronously imports a certificate from a Personal Information Exchange (PFX) message using the specified key storage provider.

public:
 static IAsyncAction ^ ImportPfxDataAsync(Platform::String ^ pfxData, Platform::String ^ password, ExportOption exportable, KeyProtectionLevel keyProtectionLevel, InstallOptions installOption, Platform::String ^ friendlyName, Platform::String ^ keyStorageProvider);

/// [Windows.Foundation.Metadata.Overload("ImportPfxDataToKspAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static 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 static 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 Shared 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

Parameters

pfxData: String
Platform::String

winrt::hstring

Base64-encoded PFX message.

password: String
Platform::String

winrt::hstring

The password used to decrypt and verify the PFX packet. The password must be exactly the same as the password that was used to encrypt the packet.

exportable: ExportOption

A value of the ExportOption enumeration that specifies whether the key can be exported.

keyProtectionLevel: KeyProtectionLevel

A value of the KeyProtectionLevel enumeration that specifies the strength of the key protection. The default is NoConsent.

installOption: InstallOptions

An InstallOptions enumeration value that specifies the certificate installation option.

friendlyName: String
Platform::String

winrt::hstring

The display name of the enrolled certificate. This value overwrites the FriendlyName property inside the PFX message.

keyStorageProvider: String
Platform::String

winrt::hstring

The name of the key storage provider to use when importing the certificate.

Returns

IAsyncAction

This method does not return a value.

Attributes: OverloadAttribute RemoteAsyncAttribute

Remarks

This method imports the certificate chain into the app container.

To import an issued certificate, it is not necessary for the certificate request to have been generated on the importing computer.
The certificates included in the response need not be chained to trusted root certificates on the importing computer.
The certificate is installed in the app container MY store.
Certification authority and Root certificates are installed in the app container intermediate certification authority store.
The key container name and key specification for the imported certificate are determined as described in the Remarks section of PFXImportCertStore with the exception that if AttributeId 1.3.6.1.4.1.311.17.1 is not present, MS_KEY_STORAGE_PROVIDER is always used as the provider name.

Applies to

Share via

CertificateEnrollmentManager.ImportPfxDataAsync Method

Definition

Overloads

ImportPfxDataAsync(String, String, PfxImportParameters)

Parameters

Returns

See also

Applies to

ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)

Parameters

Returns

Remarks

See also

Applies to

ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)

Parameters

Returns

Remarks

See also

Applies to

Feedback

Additional resources