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 |
|---|---|
|
Vorgang erfolgreich. |
|
Berechtigungsfehler, Zugriff verweigert. |
|
Systemressourcenlimit, konnte den Vorgang nicht ausführen. |
|
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 |
|
| IDL |
|
| DLL |
|