ICertEncodeAltName::GetName method (certenc.h)

The GetName method returns the specified name from the alternate name array.

Syntax

HRESULT GetName(
  [in]  LONG NameIndex,
  [out] BSTR *pstrName
);

Parameters

[in] NameIndex

A zero-based index that specifies the index of the alternate name entry to retrieve.

To retrieve the object identifier (OID) of a CERT_ALT_NAME_OTHER_NAME name, combine the index value with EAN_NAMEOBJECTID (defined as 0x80000000) with a bitwise-OR operation. Otherwise, the binary value is retrieved. To determine the type of name, call the ICertEncodeAltName::GetNameChoice method.

[out] pstrName

A pointer to a BSTR that receives the alternate name. When you have finished using the BSTR, free it by calling the SysFreeString function.

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 alternate name at the specified index. The return value is a Unicode string.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows ServerĀ 2003 [desktop apps only]
Target Platform Windows
Header certenc.h (include Certsrv.h)
Library Certidl.lib
DLL Certenc.dll

See also

ICertEncodeAltName

ICertEncodeAltName::GetNameChoice

ICertEncodeAltName::SetNameEntry