INapSoHProcessor::FindNextAttribute method

The INapSoHProcessor::FindNextAttribute method finds the location (index) of the next attribute of the type indicated by SoHAttributeType.

Syntax

HRESULT FindNextAttribute(
  [in]  UINT16           fromLocation,
  [in]  SoHAttributeType type,
  [out] UINT16           *attributeLocation
);

Parameters

fromLocation [in]

The starting location (index) in the Statement of Health (SoH) packet to begin the attribute search. This value must be in the range of 0 to (numAttrib - 1) where numAttrib is retrieved using INapSoHProcessor::GetNumberOfAttributes.

Note

The SoH packet uses 0-based attribute indices.

type [in]

An SoHAttributeType structure that contains the attribute type to locate.

attributeLocation [out]

A pointer that contains the location (index) in the SoH packet of the first attribute of type SoHAttributeType from the index fromLocation.

Return value

Other COM-specific error codes also may be returned.

Remarks

The FindNextAttribute method searches for attributes of type SoHAttributeType from the index specified by fromLocation and higher until a match is found. If no match is found, ERROR_FILE_NOT_FOUND is returned.

Requirements

See also

INapSoHProcessor