ICEnroll4::InstallPKCS7Ex method (xenroll.h)

Article
02/22/2024

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

The InstallPKCS7Ex method processes a certificate or chain of certificates, placing them into the appropriate certificate stores. The InstallPKCS7Ex method is the same as InstallPKCS7 except that it returns the number of certificates actually installed in local stores. This method was first defined in the ICEnroll4 interface.

Syntax

HRESULT InstallPKCS7Ex(
  [in]  BSTR PKCS7,
  [out] LONG *plCertInstalled
);

Parameters

[in] PKCS7

A string that contains a certificate or chain of certificates.

[out] plCertInstalled

Returns the number of certificates installed into local stores.

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

A Long that contains the number of certificates installed into local stores.

Remarks

When this method is called from script, the method displays a user interface that asks whether the user will allow installation of a 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