ICEnroll4::addCertTypeToRequestEx method

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

The addCertTypeToRequestEx method, like the addCertTypeToRequest method, adds a certificate template (or "certificate type") to a request. This method was first defined in the ICEnroll4 interface.

This method is associated with the Certificate Services enterprise policy module. This method is specialized, and its use is not recommended for most applications. This version can add a V@ template extension into a request.

Syntax


HRESULT addCertTypeToRequestEx(
  [in] LONG lFlag,
  [in] BSTR bstrOIDOrName,
  [in] LONG lMajorVersion,
  [in] BOOL fMinorVersion,
  [in] LONG lMinorVersion
);

Parameters

lFlag [in]

Indicates the version type of the template extension. This can be either of the following values:

ValueMeaning
XECT_EXTENSION_V1

Uses a version 1 extension

XECT_EXTENSION_V2

Uses a version 2 extension

 

bstrOIDOrName [in]

The certificate template fully qualified name which is being added to the certificate request. This value is interpreted by the certification authority.

lMajorVersion [in]

Sets the major version of the template. This parameter is ignored if lFlag is XECT_EXTENSION_V!.

fMinorVersion [in]

Indicates whether a minor version of the template is used. This parameter is ignored if lFlag is XECT_EXTENSION_V!.

lMinorVersion [in]

Sets the minor version of the template. This parameter is ignored if lFlag is XECT_EXTENSION_V1 or if fMinorVersion is FALSE.

Return value

VB

The return value is an HRESULT, with S_OK returned if the call is successful.

Remarks

This method supports only the new request method, createRequest. It does not support the createPKCS10 method.

This method can be called multiple times to establish multiple certificate templates for the request.

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

See also

ICEnroll4
CEnroll
ICEnroll::createPKCS10
ICEnroll2::addCertTypeToRequest
ICEnroll4::createRequest

 

 

Show: