SoHAttributeValue-Union

Artikel
06/13/2023

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die SoHAttributeValue-Union definiert den Inhalt des Typmembers in einer SoHAttribute-Struktur. Die Struktur der SoHAttributeValue-Union wird durch den SoHAttributeType bestimmt, der im Typmember der SoHAttribute-Struktur angegeben ist.

Syntax

typedef union tagSoHAttributeValue {
  SystemHealthEntityId     idVal;
  struct tagIpv4Addresses {
    UINT16      count;
    Ipv4Address *addresses;
  } v4AddressesVal;
  struct tagIpv6Addresses {
    UINT16      count;
    Ipv6Address *addresses;
  } v6AddressesVal;
  ResultCodes              codesVal;
  FILETIME                 dateTimeVal;
  struct tagVendorSpecific {
    UINT32 vendorId;
    UINT16 size;
    BYTE   *vendorSpecificData;
  } vendorSpecificVal;
  UINT8                    uint8Val;
  struct tagOctetString {
    UINT16 size;
    BYTE   *data;
  } octetStringVal;
} SoHAttributeValue;

Member

idVal

case(sohAttributeTypeSystemHealthId)

Eine eindeutige SystemHealthEntityId , die die ID des SystemIntegritäts-Agents (SHA) oder des System Health Validator (SHV) enthält, der dieses SoH-Paket erstellt hat.

v4AddressesVal

case(sohAttributeTypeIpv4FixupServers)

Die IPv4-Adressen der vom NAP-System verwendeten Fixupserver.

count: Die Anzahl der IPv4-Adressen im Adresselement im Bereich 1 bis maxIpv4CountPerSoHAttribute.
addresses: Ein Array von Ipv4Address-Strukturen , die die IPv4-Adressen enthalten.

v6AddressesVal

case(sohAttributeTypeIpv6FixupServers)

Die IPv6-Adressen der vom NAP-System verwendeten Fixupserver.

count: Die Anzahl der IPv4-Adressen im Adresselement im Bereich 1 bis maxIpv6CountPerSoHAttribute.
addresses: Ein Array von Ipv6Address-Strukturen , die die IPv4-Adressen enthalten.

codesVal

case(sohAttributeTypeComplianceResultCodes, sohAttributeTypeErrorCodes)

Eine ResultCodes-Struktur , die entweder die von der Anwendung definierten Konformitätsergebniscodes des Clients oder NAP-Fehlerkonstanten enthält. Ein SoH-Paket muss diesen TLV oder den TLV sohAttributeTypeFailureCategory enthalten.

dateTimeVal

case(sohAttributeTypeTimeOfLastUpdate, sohAttributeTypeSoHGenerationTime)

Eine FILETIME-Struktur , die die Zeit des letzten SoH-Updates oder die SoH-Generierungszeit enthält.

vendorSpecificVal

case(sohAttributeTypeVendorSpecific)

Anwendungsspezifische Daten, die vom Anbieter definiert werden.

Vendorid: Ein 4-Byte-Bezeichner, der die SHA/SHV-Paar-ID definiert. Die ersten 3 Bytes sind der vom IETF zugewiesene SMI-Code des Anbieters, und das letzte Byte identifiziert die Komponente selbst. Verwenden Sie beim Implementieren eines SHA oder SHV nicht die ID-Werte, die internen Microsoft-Systemintegritätskomponenten für NAP-Anbieterkonstanten zugewiesen sind.
size: Die Größe der Anbieterdaten in Bytes im Bereich 0 bis (maxSoHAttributeSize - 4).
vendorSpecificData: Ein Zeiger auf die anbieterspezifischen Daten in Netzwerkbytereihenfolge.

uint8Val

case(sohAttributeTypeHealthClass, sohAttributeTypeFailureCategory,sohAttributeTypeExtendedIsolationState)

Die Integritätsklasse, Fehlerkategorie oder erweiterter Isolationsstatus einer NAP-Komponente als HealthClassValue - oder FailureCategory-Wert oder als IsolationInfoEx-Struktur .

octetStringVal

default

Die Werte der folgenden Attribute sind Oktettzeichenfolgen:

sohAttributeTypeSoftwareVersion
sohAttributeTypeClientId
sohAttributeTypeProductName
sohAttributeTypeHealthClassStatus

Aus Gründen der Vorwärtskompatibilität werden alle nicht erkannten Attribute als Oktettzeichenfolgen zurückgegeben. Die Daten müssen sich in der Reihenfolge des Netzwerkbytes befinden.

size: Die Größe von Daten in Bytes im Bereich 0 bis maxSoHAttributeSize.
data: Ein Zeiger auf den Oktettzeichenfolgenwert.

Tatsächliches Datenlayout

Aufgrund der Art der SDK-Veröffentlichungsumgebung sind Vereinigungen in Syntaxblöcken nicht eindeutig dargestellt. Hier sehen Sie die tatsächliche Syntax aus der Headerdatei NapProtocol.h.

#include <windows.h>

typedef [switch_type(SoHAttributeType)] 
   union tagSoHAttributeValue
   {
      [case(sohAttributeTypeSystemHealthId)]
         SystemHealthEntityId idVal;
   
      [case(sohAttributeTypeIpv4FixupServers)]
         struct tagIpv4Addresses
         {
            [range(1, maxIpv4CountPerSoHAttribute)] 
               UINT16 count;
            [size_is(count)] Ipv4Address* addresses;
         } v4AddressesVal;

      [case(sohAttributeTypeIpv6FixupServers)]
         struct tagIpv6Addresses
         {
            [range(1, maxIpv6CountPerSoHAttribute)]
               UINT16 count;
            [size_is(count)] Ipv6Address* addresses;
         } v6AddressesVal;

      [case(sohAttributeTypeComplianceResultCodes, 
            sohAttributeTypeErrorCodes)]
         ResultCodes codesVal;

      [case(sohAttributeTypeTimeOfLastUpdate, 
            sohAttributeTypeSoHGenerationTime)]
         FILETIME dateTimeVal;

      [case(sohAttributeTypeVendorSpecific)]
         struct tagVendorSpecific
         {
            UINT32 vendorId;
            [range(0, maxSoHAttributeSize - 4)] 
               UINT16 size;
            [size_is(size)] BYTE* vendorSpecificData;
         } vendorSpecificVal;

      [case(sohAttributeTypeHealthClass, 
            sohAttributeTypeFailureCategory,
            sohAttributeTypeExtendedIsolationState)]
         UINT8 uint8Val;

      [default]
         struct tagOctetString
         {
            [range(0, maxSoHAttributeSize)] UINT16 size;
            [size_is(size)] BYTE* data;
         } octetStringVal;

   } SoHAttributeValue;
};

Bemerkungen

Diese Attributtypen werden vom NAP-System verwendet:

sohAttributeTypeSystemHealthId
sohAttributeTypeIpv4FixupServers
sohAttributeTypeIpv6FixupServers
sohAttributeTypeComplianceResultCodes
sohAttributeTypeFailureCategory

Die restlichen SoHAttributeTypes sind rein als präskriptive Anleitung für die Verwendung durch SHAs und SHVs gedacht.

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

Weitere Informationen

NAP-Referenz
NAP-Strukturen

Freigeben über