SetNameEntry Method
Collapse the table of content
Expand the table of content

ICertEncodeCRLDistInfo::SetNameEntry method

The SetNameEntry method sets a name at a specified index of a distribution point in a certificate revocation list (CRL) distribution information array.

Syntax


HRESULT SetNameEntry(
  [in]       LONG DistPointIndex,
  [in]       LONG NameIndex,
  [in]       LONG NameChoice,
  [inconst BSTR strName
);

Parameters

DistPointIndex [in]

Specifies the index of the CRL distribution point for which to set the name. The first value is at index zero.

NameIndex [in]

Specifies the index of the name entry to set. The first value is at index zero.

NameChoice [in]

Specifies the name choice of the name being set. The name choice indicates the type of the name so that it can be used correctly. The name choice must be one of the following values.

ValueMeaning
CERT_ALT_NAME_RFC822_NAME

The name is an email address.

CERT_ALT_NAME_DNS_NAME

The name is an IA5 string specifying a DNS (Domain Name System) name in the format host.entity.domain.

CERT_ALT_NAME_URL

The name is an IA5 string specifying a URL in the format Service://HostName/Path.

CERT_ALT_NAME_REGISTERED_ID

The name is a registered object identifier (OID).

 

strName [in]

Specifies the name.

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.

Examples

For an example that uses the SetNameEntry method, see the ICertEncodeCRLDistInfo::Encode method.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Certenc.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certenc.dll

IID

IID_ICertEncodeCRLDistInfo is defined as 01958640-bbff-11d0-8825-00a0c903b83c

See also

ICertEncodeCRLDistInfo
ICertEncodeCRLDistInfo::GetName
ICertEncodeCRLDistInfo::GetNameChoice
ICertEncodeCRLDistInfo::SetNameCount

 

 

Show:
© 2016 Microsoft