INapSoHConstructor::AppendAttribute-Methode

Hinweis

Die Netzwerkzugriffsschutz-Plattform ist ab dem Windows 10

Die INapSoHConstructor::AppendAttribute-Methode fügt am Ende des SoH-Puffers einen TLV hinzu.

Syntax

HRESULT AppendAttribute(
  [in]       SoHAttributeType  type,
  [in] const SoHAttributeValue *value
);

Parameter

type [ In]

Eine SoHAttributeType-Enumeration, die den Attributtyp des neuen TLV angibt.

value [ In]

Ein Zeiger auf eine SoHAttributeValue-Struktur, die den Wert für den neuen TLV 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.

Bemerkungen

Das TLV sohAttributeTypeSystemHealthId darf nicht mit dieser Funktion hinzugefügt werden. Es wird als erstes TLV von INapSoHConstructor::Initialize zu neu erstellten SOH-Paketen hinzugefügt.

Beim Anfügen eines Attributs, das vom Nap-System verwendet wird, sollte es nicht verschlüsselt oder in irgendeiner Weise geändert werden. Wenn HealthEntity eine Verschlüsselungs-/Integritätsüberprüfung (ENCRYPTION/Integrity Checking, MACs) privater Informationen erfordert, sollte sie nur im attribut sohAttributeTypeVendorSpecific enthalten sein.

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

INapSoHConstructor