INapSoHConstructor::Initialize method

Note

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

The INapSoHConstructor::Initialize method initializes a SoH protocol packet in the NAP system.

Syntax

HRESULT Initialize(
  [in] SystemHealthEntityId id,
  [in] BOOL                 isRequest
);

Parameters

id [in]

A unique SystemHealthEntityId that contains the ID of the SHA or SHV that is constructing the packet.

isRequest [in]

A BOOL that is TRUE if the packet is to be an SoHRequest and FALSE if it is to be an SoHResponse.

Return value

Other COM-specific error codes also may be returned.

Return code Description
S_OK
Operation successful.
E_ACCESSDENIED
Permissions error, access denied.
E_OUTOFMEMORY
System resource limit, could not perform the operation.

Remarks

This method must be called exactly once per packet.

The SystemHealthEntityId specified in id, is the first TLV in the newly constructed SOH packet and has the attribute type sohAttributeTypeSystemHealthId.

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