ICEnroll::getCertFromPKCS7 method (xenroll.h)

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

The getCertFromPKCS7 method retrieves the certificate, contained in a PKCS #7 message, that was issued in response to a PKCS #10 certificate request. This method was first defined by the ICEnroll interface.

This method retrieves the single certificate that was issued even though a PKCS #7 message may contain many certificates that specify the certification chain of authority that issued the certificate.

Syntax

HRESULT getCertFromPKCS7(
  [in]  BSTR wszPKCS7,
  [out] BSTR *pbstrCert
);

Parameters

[in] wszPKCS7

Specifies the PKCS #7 from which the issued certificate is being retrieved.

[out] pbstrCert

A pointer to a BSTR variable to receive the issued certificate. 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 string that contains the issued certificate.

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