INapSoHConstructor::AppendAttribute method

Note

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

The INapSoHConstructor::AppendAttribute method adds a TLV to the end of the SoH buffer.

Syntax

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

Parameters

type [in]

A SoHAttributeType enumeration that indicates the attribute type of the new TLV.

value [in]

A pointer to an SoHAttributeValue structure that contains the value for the new TLV.

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.

Remarks

The sohAttributeTypeSystemHealthId TLV must not be added using this function. It is added as the first TLV by INapSoHConstructor::Initialize to newly constructed SOH packets.

When appending an attribute which will be consumed by the Nap System, it should not be encrypted or modified in any manner. If the HealthEntity requires encryption/integrity checking (MACs) of private information, it should be included only in the sohAttributeTypeVendorSpecific attribute.

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

INapSoHConstructor