ICEnroll4::createFilePFX method (xenroll.h)

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The createFilePFX method saves the accepted certificate chain and private key in a file in Personal Information Exchange (PFX) format. This method was first defined in the ICEnroll4 interface.

Syntax

HRESULT createFilePFX(
  [in] BSTR strPassword,
  [in] BSTR strPFXFileName
);

Parameters

[in] strPassword

A password for the PFX; this value can be empty (or NULL) to indicate that no password is used. When you have finished using the password, clear it from memory by calling the SecureZeroMemory function. For more information about handling passwords, see Handling Passwords.

[in] strPFXFileName

The name of the file that will receive the base64-encoded PFX data.

Return value

VB

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

When this method is called from script, the method displays a user interface that asks whether the user will allow a write operation to the file system.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	xenroll.h
Library	Uuid.lib
DLL	Xenroll.dll