Export (0) Print
Expand All

IEnumCERTVIEWCOLUMN::GetDisplayName method

The GetDisplayName method retrieves the localized name of the current column in the column-enumeration sequence.

Syntax


HRESULT GetDisplayName(
  [out]  BSTR *pstrOut
);

Parameters

pstrOut [out]

A pointer to a variable of BSTR type that contains the localized name of the column.

Return value

C++

If the method succeeds, the method returns S_OK and the pstrOut parameter contains the localized name of the column.

To use this method, create a variable of BSTR type, set the variable equal to NULL, and pass the address of this variable as pstrOut. When you have finished using the BSTR, free it by calling the SysFreeString function.

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 a String that contains the localized name of the column.

Remarks

This method is used to retrieve the localized name of the column currently referenced by the column-enumeration sequence.

If the column-enumeration sequence is not referencing a valid column, GetDisplayName will fail. Use one of the following methods to navigate through the enumeration:

Examples


BSTR     bstrDisplay = NULL;
HRESULT  hr;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetDisplayName(&bstrDisplay);
if (S_OK == hr)
    printf("Column name is %ws\n", bstrDisplay);

// Done processing, clear resources.
if (NULL != bstrDisplay)
    SysFreeString(bstrDisplay);

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Certview.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certadm.dll

IID

IID_IEnumCERTVIEWCOLUMN is defined as 9c735be2-57a5-11d1-9bdb-00c04fb683fa

See also

IEnumCERTVIEWCOLUMN
IEnumCERTVIEWCOLUMN::Next
IEnumCERTVIEWCOLUMN::Reset
IEnumCERTVIEWCOLUMN::Skip

 

 

Community Additions

ADD
Show:
© 2014 Microsoft