IEnumCERTVIEWROW::EnumCertViewAttribute

[This is preliminary documentation and subject to change.]

The EnumCertViewAttribute method obtains an instance of the IEnumCERTVIEWATTRIBUTE object.

[VB] CEnumCERTVIEWATTRIBUTE EnumCertViewAttribute(
  Long Flags
);
 
[JAVA] CEnumCERTVIEWATTRIBUTE EnumCertViewAttribute(
  int Flags
);
 
[C++] HRESULT EnumCertViewAttribute(
  LONG Flags,                      // in
  IEnumCERTVIEWATTRIBUTE **ppenum  // out
);

Parameters

Flags: LONG value. Must be zero.
[C++] ppenum: Pointer to pointer of IEnumCERTVIEWATTRIBUTE type. Upon successful completion of this function, ppenum will point to a pointer of IEnumCERTVIEWATTRIBUTE type.

Return Values

[VB][JAVA] The returned object is a IEnumCERTVIEWATTRIBUTE object.

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

Remarks

The IEnumCERTVIEWATTRIBUTE object can be used to enumerate the certificate's attributes.

Example

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                     hr;
LONG                        Index;
IEnumCERTVIEWATTRIBUTE *    pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute( 0, &pEnumAttr );
if ( FAILED( hr ))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr );
    goto error;
}
// enumerate each attribute
while ( S_FALSE != pEnumAttr->Next( &Index ) )
{
    // do something with this attribute
    //…
}
error:

// free resources
if ( NULL != pEnumAttr )
    pEnumAttr->Release();

QuickInfo