CertificateEnrollmentManager.ImportPfxDataAsync Method
Definition
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)
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 IAsyncActionParameters
- 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
This method does not return a value.
- Attributes
See also
- ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)
- ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)
Applies to
ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String)
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 IAsyncActionParameters
- 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
This method does not return a value.
- Attributes
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.
See also
- ImportPfxDataAsync(String, String, ExportOption, KeyProtectionLevel, InstallOptions, String, String)
Applies to
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.
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 IAsyncActionParameters
- 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
This method does not return a value.
- Attributes
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.
See also
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for