IEnumCERTVIEWEXTENSION::GetName

[This is preliminary documentation and subject to change.]

The GetName method retrieves the name of the extension.

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

Parameters

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

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 name of the extension currently referenced by the IEnumCERTVIEWEXTENSION object.

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

Example

BSTR    bstrExtName = NULL;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if ( S_OK == hr )
    printf("Extentsion name is: %S\n", bstrExtName );
else
    printf("GetName failed: %x\n", hr );

// free memory when done
if ( NULL != bstrExtName )
    SysFreeString( bstrExtName );

QuickInfo