CLUSPROP_SYNTAX Union (clusapi.h)

Artikel
02/28/2024

Beschreibt das Format und den Typ eines Datenwerts. Es wird als Syntaxelement der CLUSPROP_VALUE-Struktur verwendet.

Syntax

typedef union CLUSPROP_SYNTAX {
  DWORD  dw;
  struct {
    WORD wFormat;
    WORD wType;
  } DUMMYSTRUCTNAME;
} CLUSPROP_SYNTAX, *PCLUSPROP_SYNTAX;

Member

dw

Ein DWORD, das das Format und den Typ des Datenwerts beschreibt. Die CLUSTER_PROPERTY_SYNTAX-Enumeration definiert die möglichen Werte.

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.wFormat

Numerischer Wert, der nur das Format des Datenwerts beschreibt. ClusAPI.h definiert die folgenden Werte, die in der CLUSTER_PROPERTY_FORMAT-Enumeration aufgelistet sind.

wFormat.CLUSPROP_FORMAT_BINARY (1)

Daten sind ein binärer Wert.

wFormat.CLUSPROP_FORMAT_DWORD (2)

Daten sind ein DWORD-Wert .

wFormat.CLUSPROP_FORMAT_EXPAND_SZ (4)

Daten sind eine Unicode-Zeichenfolge mit Null-Endung mit nicht erweiterten Verweisen auf Umgebungsvariablen.

wFormat.CLUSPROP_FORMAT_EXPANDED_SZ (8)

Daten sind eine Unicode-Zeichenfolge mit Null-Endung mit erweiterten Verweisen auf Umgebungsvariablen.

wFormat.CLUSPROP_FORMAT_FILETIME (12 (0xC))

Daten sind filetime.

wFormat.CLUSPROP_FORMAT_LARGE_INTEGER (10 (0xA))

Daten sind eine große ganze Zahl mit Vorzeichen.

wFormat.CLUSPROP_FORMAT_LONG (7)

Data ist ein signierter LONG-Wert .

wFormat.CLUSPROP_FORMAT_MULTI_SZ (5)

Daten sind ein Array von Unicode-Zeichenfolgen mit Null-Beendigung.

wFormat.CLUSPROP_FORMAT_SECURITY_DESCRIPTOR (9)

Daten sind ein SECURITY_DESCRIPTOR im selbstrelativen Format. Weitere Informationen zu selbstrelativen Sicherheitsdeskriptoren finden Sie unter Absolute und Self-Relative Sicherheitsdeskriptoren.

wFormat.CLUSPROP_FORMAT_SZ (3)

Daten sind eine Unicode-Zeichenfolge mit NULL-Beendigung.

wFormat.CLUSPROP_FORMAT_ULARGE_INTEGER (6)

Daten sind eine große ganze Zahl ohne Vorzeichen.

wFormat.CLUSPROP_FORMAT_UNKNOWN (0)

Die Daten haben ein unbekanntes Format.

wFormat.CLUSPROP_FORMAT_USER (32768 (0x8000))

Die Daten haben ein benutzerdefiniertes Format.

wFormat.CLUSPROP_FORMAT_WORD (11 (0xB))

Daten sind ein WORD-Wert .

DUMMYSTRUCTNAME.wType

Numerischer Wert, der nur den Typ des Datenwerts beschreibt. Die CLUSTER_PROPERTY_TYPE-Enumeration definiert die möglichen Werte.

wType.CLUSPROP_TYPE_DISK_NUMBER (7)

Beschreibt den Zahlenwert einer Datenträgerressource. Ein Datenträgernummerwert wird durch eine CLUSPROP_DISK_NUMBER-Struktur dargestellt.

wType.CLUSPROP_TYPE_DISK_SERIALNUMBER (10 (0xA))

Beschreibt die Seriennummer einer Datenträgerressource.

wType.CLUSPROP_TYPE_DISK_GUID (11 (0xB))

Beschreibt die GUID einer Datenträgerressource.

wType.CLUSPROP_TYPE_DISK_SIZE (12 (0xC))

Beschreibt die Gesamtgröße des Datenträgers.

wType.CLUSPROP_TYPE_ENDMARK (0)

Legt den Datenwert als letzten Eintrag in einer Eigenschafts- oder Wertliste fest.

wType.CLUSPROP_TYPE_LIST_VALUE (1)

Beschreibt einen Datenwert in einer Eigenschaftsliste. Beispiel: In der Eigenschaftsliste, die an eine Steuerelementcodefunktion für einen Eigenschaftsüberprüfungsvorgang übergeben wird, ist CLUSPROP_TYPE_LIST_VALUE der erforderliche Typ, der in jeden Eigenschaftswert eingeschlossen werden muss.

wType.CLUSPROP_TYPE_NAME (4)

Beschreibt einen Datenwert, der als Name verwendet wird, z. B. ein Eigenschaftsname. Ein Name-Wert wird durch eine CLUSPROP_PROPERTY_NAME-Struktur dargestellt.

wType.CLUSPROP_TYPE_PARTITION_INFO (8)

Beschreibt eine Sammlung von Informationen zu einer Datenträgerressource, z. B. gerätename und Volumebezeichnung. Partitionsdaten werden durch eine CLUSPROP_PARTITION_INFO-Struktur dargestellt.

wType.CLUSPROP_TYPE_PARTITION_INFO_EX (13 (0xD))

Beschreibt eine Sammlung von Informationen zu einer Datenträgerressource, z. B. gerätename und Volumebezeichnung. Partitionsdaten werden durch eine CLUSPROP_PARTITION_INFO_EX-Struktur dargestellt.

wType.CLUSPROP_TYPE_RESCLASS (2)

Beschreibt Ressourcenklasseninformationen. Ein Ressourcenklassenwert wird mit einer CLUSPROP_RESOURCE_CLASS-Struktur beschrieben. Ressourcenklassen werden zurückgegeben, wenn eine Anwendung ClusterResourceControl oder ClusterResourceTypeControl mit einem der folgenden Steuerelementcodes aufruft.

CLUSCTL_RESOURCE_GET_CLASS_INFO

CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO

CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES

wType.CLUSPROP_TYPE_SCSI_ADDRESS (6)

Beschreibt eine Address-Eigenschaft für eine IP-Adressressource . Ein SCSI-Adresswert wird durch eine CLUSPROP_SCSI_ADDRESS-Struktur dargestellt.

wType.CLUSPROP_TYPE_SIGNATURE (5)

Beschreibt eine Signature-Eigenschaft für eine Datenträgerressource. Ein Signaturwert wird durch eine CLUSPROP_DISK_SIGNATURE-Struktur dargestellt.

wType.CLUSPROP_TYPE_UNKNOWN (-1)

Der Typ ist unbekannt.

wType.CLUSPROP_TYPE_USER (32768 (0x8000))

Beschreibt den Anfang des Bereichs, in dem Benutzer ihre eigenen Typen definieren können. Ordnen Sie diesen Typ benutzerdefinierten privaten Eigenschaften zu.

Hinweise

Um Daten zu analysieren, die von einer Steuerelementcodefunktion zurückgegeben werden, verwenden Sie das wFormat-Element dieser Struktur, wenn das wType-Element einen Typ definiert, den die Anwendung nicht verstehen kann.

Beispiele

Weitere Informationen finden Sie unter Erstellen physischer Datenträgerressourcen und Erstellen mit CLUSPROP_BUFFER_HELPER.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Kopfzeile	clusapi.h