IEnumCERTVIEWATTRIBUTE::Skip

[This is preliminary documentation and subject to change.]

The Skip method skips a specified number of attributes in the IEnumCERTVIEWATTRIBUTE enumeration sequence.

[VB] Skip(
  Long celt
);
 
[JAVA] Skip(
  int celt
);
 
[C++] HRESULT Skip(
  LONG celt  // in
);

Parameters

celt: Number of attributes for the IEnumCertViewAttribute object to skip. A positive value for celt causes the IEnumCertViewAttribute object to skip forward in the enumeration sequence; a negative value for celt causes the IEnumCertViewAttribute object to skip backward in the enumeration sequence.

Return Values

[C++] The return value is an HRESULT. A value of S_OK indicates success. A return value of E_INVALIDARG indicates that a negative value for celt caused the IEnumCERTVIEWATTRIBUTE object's index to become less than zero.

Remarks

Upon successful completion of this function, the IEnumCERTVIEWATTRIBUTE object will have skipped celt attributes in the enumeration sequence. To access the attribute contents after a call to the IEnumCERTVIEWATTRIBUTE Skip method, call the IEnumCERTVIEWATTRIBUTE Next method.

The IEnumCERTVIEWATTRIBUTE object maintains an internal value representing the zero-based index of the attribute to be accessed when the IEnumCERTVIEWATTRIBUTE Next method is called. A call to the IEnumCERTVIEWATTRIBUTE Skip method causes this index to increase by celt if celt is positive, or to decrease by celt if celt is negative.

Negative values for celt are validated, and this function will fail if celt causes the index to be less than zero.

Positive values for celt are not validated, but if a positive value for celt causes the internal value to exceed the index for the last column in the enumeration sequence, a subsequent call to the IEnumCERTVIEWATTRIBUTE Next method will fail.

Example

HRESULT    hr;
LONG        Index;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip( 5 );
if ( S_OK == hr ) 
{
    // get the next attribute
    hr = pEnumAttr->Next( &Index );
    if ( S_OK  == hr )
    {
        // do something with this attribute
        //…
    }
}

QuickInfo