INapSoHProcessor::FindNextAttribute method

Note

The Network Access Protection platform is not available starting with Windows 10

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.

Return code	Description
S_OK	Operation succeeded.
E_ACCESSDENIED	Permissions error, access denied.
E_OUTOFMEMORY	System resource limit, could not perform the operation.
ERROR_FILE_NOT_FOUND	Attribute not found.

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

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	NapProtocol.h
IDL	NapProtocol.idl
DLL	Qutil.dll

See also

INapSoHProcessor