ICEnroll4::createPFX method

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

The createPFX method saves the accepted certificate chain and private key in a Personal Information Exchange (PFX) format string. The PFX format is also known as PKCS #12. This method was first defined in the ICEnroll4 interface.

Syntax


HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

Parameters

strPassword [in]

A password for the PFX-format message. 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 protecting the password, see Handling Passwords.

pstrPFX [out]

A pointer to a BSTR that receives the base64-encoded PFX format certificate information. When you have finished using the BSTR, free it by calling the SysFreeString function.

Return value

C++

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.

VB

The return value is a String that contains the PFX format certificate information.

Remarks

This method is disabled when the Certificate Enrollment Control is executed as a scripted control.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_ICEnroll4 is defined as c1f1188a-2eb5-4a80-841b-7e729a356d90

 

 

Show: