INapSoHProcessor::FindNextAttribute-Methode

Artikel
06/13/2023

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die INapSoHProcessor::FindNextAttribute-Methode findet den Speicherort (Index) des nächsten Attributs des typs, der durch SoHAttributeType angegeben ist.

Syntax

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

Parameter

fromLocation [in]: Der Startspeicherort (Index) im SoH-Paket (Statement of Health), um die Attributsuche zu starten. Dieser Wert muss im Bereich von 0 bis (numAttrib - 1) liegen, wobei numAttrib mithilfe von INapSoHProcessor::GetNumberOfAttributes abgerufen wird.

Hinweis

Das SoH-Paket verwendet 0-basierte Attributindizes.
Geben Sie [in] ein.: Eine SoHAttributeType-Struktur , die den zu suchenden 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

Es können auch andere COM-spezifische Fehlercodes zurückgegeben werden.

Rückgabecode	BESCHREIBUNG
S_OK	Vorgang erfolgreich.
E_ACCESSDENIED	Berechtigungsfehler, Zugriff verweigert.
E_OUTOFMEMORY	Systemressourcenlimit konnte den Vorgang nicht ausführen.
ERROR_FILE_NOT_FOUND	Das Attribut wurde nicht gefunden.

Bemerkungen

Die FindNextAttribute-Methode sucht nach Attributen des Typs SoHAttributeType aus dem durch fromLocation angegebenen Index und höher, bis eine Übereinstimmung gefunden wird. Wenn keine Übereinstimmung gefunden wird, wird ERROR_FILE_NOT_FOUND zurückgegeben.

Anforderungen

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

Siehe auch

INapSoHProcessor

Freigeben über