ICEnroll4::createFileRequest method

[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

Flags [in]

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

ValueMeaning
XECR_CMC

Full CMC

XECR_PKCS10_V1_5

PKCS 10

XECR_PKCS10_V2_0

PKCS 10 version 2

XECR_PKCS7

PKCS 7

 

strDNName [in]

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.

strUsage [in]

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.

strRequestFileName [in]

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

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft