Edit

Share via

ImportPFXToProvider callback function (certenroll.h)

  • Article

Imports a PFX certificate.

Syntax

ImportPFXToProvider Importpfxtoprovider;

HRESULT Importpfxtoprovider(
  [in]            HWND hWndParent,
  [in]            BYTE const *pbPFX,
  [in]            DWORD cbPFX,
  [in]            ImportPFXFlags ImportFlags,
  [in, optional]  PCWSTR pwszPassword,
  [in, optional]  PCWSTR pwszProviderName,
  [in, optional]  PCWSTR pwszReaderName,
  [in, optional]  PCWSTR pwszContainerNamePrefix,
  [in, optional]  PCWSTR pwszPin,
  [in, optional]  PCWSTR pwszFriendlyName,
  [out, optional] DWORD *pcCertOut,
  [out, optional] PCCERT_CONTEXT **prgpCertOut
)
{...}

Parameters

[in] hWndParent

Handle to a Parent Window.

[in] pbPFX

Pointer to a buffer that contains the PFX file.

[in] cbPFX

Size of pbPFX in bytes.

[in] ImportFlags

One or more ImportPFXFlag values.

[in, optional] pwszPassword

Pointer to a constant null-terminated string of 16-bit Unicode characters that is the Password for the PFX file.

[in, optional] pwszProviderName

Pointer to a constant null-terminated string of 16-bit Unicode characters that is the name of the crypto provider.

[in, optional] pwszReaderName

Pointer to a constant null-terminated string of 16-bit Unicode characters that is the name of the smart card reader (can be nullptr).

[in, optional] pwszContainerNamePrefix

Pointer to a constant null-terminated string of 16-bit Unicode characters that is the name of the container (can be nullptr).

[in, optional] pwszPin

Pointer to a constant null-terminated string of 16-bit Unicode characters that is the PIN of the smart card (can be nullptr).

[in, optional] pwszFriendlyName

Pointer to a constant null-terminated string of 16-bit Unicode characters that is the friendly name of the certificate (can be nullptr).

[out, optional] pcCertOut

Pointer to DWORD that receives the number of certificates successfully imported (can be nullptr).

[out, optional] prgpCertOut

Pointer to a pointer that receives a CERT_CONTEXT structure (can be nullptr).

Return value

None

Requirements

Requirement Value
Target Platform Windows
Header certenroll.h