INapSoHProcessor::FindNextAttribute-Methode

Hinweis

Die Netzwerkzugriffsschutz-Plattform ist ab Windows 10 nicht verfügbar.

Die INapSoHProcessor::FindNextAttribute-Methode sucht den Speicherort (Index) des nächsten Attributs des Typs, der durch SoHAttributeType angegeben wird.

Syntax

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

Parameter

fromLocation [ In]

Der Startspeicherort (Index) im SoH-Paket (Statement of Health), an dem die Attributsuche gestartet werden soll. Dieser Wert muss im Bereich von 0 bis (numAttrib - 1) liegen, wobei numAttrib mithilfe von INapSoHProcessor::GetNumberOfAttributesabgerufen wird.

Hinweis

Das SoH-Paket verwendet 0-basierte Attributindizes.

Type (Typ) [ In]

Eine SoHAttributeType-Struktur, die den zu zuordnende Attributtyp enthält.

attributeLocation [ out]

Ein Zeiger, der den Speicherort (Index) im SoH-Paket des ersten Attributs vom Typ SoHAttributeType aus dem Index fromLocation enthält.

Rückgabewert

Andere COM-spezifische Fehlercodes können ebenfalls zurückgegeben werden.

Rückgabecode Beschreibung
S _ OK
Vorgang erfolgreich.
E _ ACCESSDENIED
Berechtigungsfehler, Zugriff verweigert.
E _ OUTOFMEMORY
Systemressourcenlimit, konnte den Vorgang nicht ausführen.
FEHLERDATEI _ _ NICHT _ GEFUNDEN
Das Attribut wurde nicht gefunden.

Bemerkungen

Die FindNextAttribute-Methode sucht nach Attributen vom Typ SoHAttributeType aus dem von fromLocation angegebenen Index und höher, bis eine Übereinstimmung gefunden wird. Wenn keine Übereinstimmung gefunden wird, wird ERROR _ FILE NOT _ _ FOUND zurückgegeben.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
NapProtocol.h
IDL
NapProtocol.idl
DLL
Qutil.dll

Weitere Informationen

INapSoHProcessor