ICertEncodeCRLDistInfo::GetNameChoice method

The GetNameChoice method returns the name choice at a specified index of a certificate revocation list (CRL) distribution information point.

Syntax


HRESULT GetNameChoice(
  [in]   LONG DistPointIndex,
  [in]   LONG NameIndex,
  [out]  LONG *pNameChoice
);

Parameters

DistPointIndex [in]

Specifies the index of the distribution point for which to get a name choice. The first value is at index zero.

NameIndex [in]

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

pNameChoice [out]

A pointer to a Long that represents the name choice.

Return value

C++

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.

VB

The return value is the name choice at the specified index. 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.

Return codeDescription
CERT_ALT_NAME_RFC822_NAME

The name is an email address.

CERT_ALT_NAME_DNS_NAME

The name is an IA5 string that contains a DNS (Domain Name System) name in the format Host.Entity.Domain.

CERT_ALT_NAME_URL

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

CERT_ALT_NAME_REGISTERED_ID

The name is a registered object identifier (OID).

 

Examples

For an example that uses the GetNameChoice 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::SetNameEntry

 

 

Community Additions

ADD
Show:
© 2014 Microsoft