объединение CLUSPROP_SYNTAX (clusapi.h)

Статья
08/22/2023

Описывает формат и тип значения данных. Он используется в качестве синтаксического элемента структуры CLUSPROP_VALUE .

Синтаксис

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

Члены

dw

DWORD, описывающий формат и тип значения данных. Перечисление CLUSTER_PROPERTY_SYNTAX определяет возможные значения.

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.wFormat

Числовое значение, описывающее только формат значения данных. ClusAPI.h определяет следующие значения, перечисленные в перечислении CLUSTER_PROPERTY_FORMAT .

wFormat.CLUSPROP_FORMAT_BINARY (1)

Данные — это двоичное значение.

wFormat.CLUSPROP_FORMAT_DWORD (2)

Данные — это значение DWORD .

wFormat.CLUSPROP_FORMAT_EXPAND_SZ (4)

Данные — это строка Юникода, заканчивающаяся нулевым значением, с нерасширившимися ссылками на переменные среды.

wFormat.CLUSPROP_FORMAT_EXPANDED_SZ (8)

Данные — это строка Юникода, оканченная null, с развернутыми ссылками на переменные среды.

wFormat.CLUSPROP_FORMAT_FILETIME (12 (0xC))

Данные — это FILETIME.

wFormat.CLUSPROP_FORMAT_LARGE_INTEGER (10 (0xA))

Данные — это большое целое число со знаком.

wFormat.CLUSPROP_FORMAT_LONG (7)

Data — это подписанное значение LONG .

wFormat.CLUSPROP_FORMAT_MULTI_SZ (5)

Данные — это массив строк Юникода, заканчивающихся нулевыми значениями.

wFormat.CLUSPROP_FORMAT_SECURITY_DESCRIPTOR (9)

Данные — это SECURITY_DESCRIPTOR в самостоятельном формате . Дополнительные сведения о самостоятельных дескрипторов безопасности см. в разделе Абсолютные и Self-Relative дескрипторы безопасности.

wFormat.CLUSPROP_FORMAT_SZ (3)

Data — это строка Юникода, завершающаяся нулевым значением.

wFormat.CLUSPROP_FORMAT_ULARGE_INTEGER (6)

Данные — это большое целое число без знака.

wFormat.CLUSPROP_FORMAT_UNKNOWN (0)

Данные в неизвестном формате.

wFormat.CLUSPROP_FORMAT_USER (32768 (0x8000))

Данные в пользовательском формате.

wFormat.CLUSPROP_FORMAT_WORD (11 (0xB))

Data — это значение WORD .

DUMMYSTRUCTNAME.wType

Числовое значение, описывающее только тип значения данных. Перечисление CLUSTER_PROPERTY_TYPE определяет возможные значения.

wType.CLUSPROP_TYPE_DISK_NUMBER (7)

Описывает числовое значение ресурса диска. Значение номера диска представлено структурой CLUSPROP_DISK_NUMBER .

wType.CLUSPROP_TYPE_DISK_SERIALNUMBER (10 (0xA))

Описывает серийный номер ресурса диска.

wType.CLUSPROP_TYPE_DISK_GUID (11 (0xB))

Описывает GUID дискового ресурса.

wType.CLUSPROP_TYPE_DISK_SIZE (12 (0xC))

Описывает общий размер диска.

wType.CLUSPROP_TYPE_ENDMARK (0)

Определяет значение данных как последнюю запись в списке свойств или значений.

wType.CLUSPROP_TYPE_LIST_VALUE (1)

Описывает значение данных в списке свойств. Например, в списке свойств, передаваемом в функцию кода элемента управления для операции проверки свойства, CLUSPROP_TYPE_LIST_VALUE является обязательным типом, который должен быть включен в каждое значение свойства.

wType.CLUSPROP_TYPE_NAME (4)

Описывает значение данных, используемое в качестве имени, например имя свойства. Значение имени представлено структурой CLUSPROP_PROPERTY_NAME .

wType.CLUSPROP_TYPE_PARTITION_INFO (8)

Описывает коллекцию сведений о ресурсе диска, например имя устройства и метку тома. Данные секционирования представлены структурой CLUSPROP_PARTITION_INFO .

wType.CLUSPROP_TYPE_PARTITION_INFO_EX (13 (0xD))

Описывает коллекцию сведений о ресурсе диска, например имя устройства и метку тома. Данные секционирования представлены структурой CLUSPROP_PARTITION_INFO_EX .

wType.CLUSPROP_TYPE_RESCLASS (2)

Описывает сведения о классе ресурсов. Значение класса ресурсов описывается со структурой CLUSPROP_RESOURCE_CLASS . Классы ресурсов возвращаются, когда приложение вызывает ClusterResourceControl или ClusterResourceTypeControl с одним из следующих кодов элементов управления.

CLUSCTL_RESOURCE_GET_CLASS_INFO

CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO

CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES

wType.CLUSPROP_TYPE_SCSI_ADDRESS (6)

Описывает свойство Address для ресурса IP-адреса . Значение адреса SCSI представлено структурой CLUSPROP_SCSI_ADDRESS .

wType.CLUSPROP_TYPE_SIGNATURE (5)

Описывает свойство Signature для дискового ресурса. Значение сигнатуры представлено структурой CLUSPROP_DISK_SIGNATURE .

wType.CLUSPROP_TYPE_UNKNOWN (-1)

Тип неизвестен.

wType.CLUSPROP_TYPE_USER (32768 (0x8000))

Описывает начало диапазона, в котором пользователи могут определять собственные типы. Свяжите этот тип с определяемыми пользователем частными свойствами.

Для анализа данных, возвращаемых функцией кода элемента управления, используйте элемент wFormat этой структуры, если член wType определяет тип, который приложение не может понять.

Примеры

См. статьи Создание ресурсов физического диска и Сборка с помощью CLUSPROP_BUFFER_HELPER.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Верхняя часть	clusapi.h