Edit

IEnroll::createFilePKCS10WStr method (xenroll.h)

  • Article

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

The createFilePKCS10WStr method creates a base64-encoded PKCS #10 certificate request and saves it in a file. This method was first defined in the IEnroll interface.

This method differs from the createPKCS10WStr method only in saving the base64-encoded PKCS #10 certificate request to the file specified by the wszPKCS10FileName parameter.

Syntax

HRESULT createFilePKCS10WStr(
  [in] LPCWSTR DNName,
  [in] LPCWSTR Usage,
  [in] LPCWSTR wszPKCS10FileName
);

Parameters

[in] DNName

The distinguished name (DN) of the entity for which the request is being made. DNName must follow the X.500 naming convention. For example, "CN=User, O=Microsoft". If a two-letter prefix does not exist, an object identifier (OID) may be provided instead.

[in] Usage

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

The OID is passed through to the PKCS #10 request. The control does not examine the OID.

[in] wszPKCS10FileName

The name of the file in which the base64-encoded PKCS #10 is saved. The contents of this file may be submitted to a certification authority for processing.

Return value

None

Remarks

By default, the Microsoft Base Cryptographic Provider is used, and a unique signature key is created.

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

See also

IEnroll