IEnumCERTVIEWCOLUMN::GetName

[This is preliminary documentation and subject to change.]

The GetName method retrieves the name of the column.

[VB] String GetName();
 
[JAVA] java.lang.String GetName();
 
[C++] HRESULT GetName(
  BSTR *pstrOut  // out
);

Parameters

[C++] pstrOut: Pointer to a BSTR type that will contain the name of the column. This function will fail if pstrOut is NULL. It is the caller's responsibility to call SysFreeString when done with pstrOut.

Return Values

[VB][JAVA] The return value is a String representing the name of the column.

[C++] The return value is an HRESULT. A value of S_OK indicates success.

Remarks

This function is used to retrieve the nonlocalized name of the Certificate Server view column currently referenced by the IEnumCERTVIEWCOLUMN object.

If the IEnumCERTVIEWCOLUMN object is not referencing a valid column, GetName will fail. Use the IEnumCERTVIEWCOLUMN Next method to reference a valid column.

Example

BSTR       bstrColName = NULL;
HRESULT    hr;

// pEnumCol is previously instantiated IEnumCERTVIEWColumn object
hr = pEnumCol->GetName( &bstrColName );
if ( S_OK == hr )
    printf("Column name is %S\n", bstrColName );

// done processing, clear resources
if ( NULL != bstrColName )
    SysFreeString( bstrColName );

QuickInfo