ICEnroll4::createFileRequest method (xenroll.h)

Article
07/27/2022

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

The createFileRequest method creates a PKCS #10 certificate request, a PKCS #7 request, or a full Certificate Management over CMS (CMC) request and stores it in a file. This method was first defined in the ICEnroll4 interface.

Syntax

HRESULT createFileRequest(
  [in] LONG Flags,
  [in] BSTR strDNName,
  [in] BSTR strUsage,
  [in] BSTR strRequestFileName
);

Parameters

[in] Flags

A value that specifies the type of certificate to create. This can be one of the following values.

Value	Meaning
XECR_CMC	Full CMC
XECR_PKCS10_V1_5	PKCS 10
XECR_PKCS10_V2_0	PKCS 10 version 2
XECR_PKCS7	PKCS 7

[in] strDNName

This parameter can be NULL; otherwise, this parameter specifies the distinguished name (DN) of the entity for which the request is being made. The DN name must follow the X.500 naming convention, for example "CN=User, O=Microsoft". If a two-letter prefix does not exist, an OID can be provided instead.

[in] strUsage

An object identifier (OID) that describes the purpose of the request being generated, for example, individual or commercial Authenticode certificate, or client authentication. You can also specify multiple OIDs separated by a comma.

[in] strRequestFileName

The name of the file that will receive the request.

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 creation of a certificate request and 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

Share via