DDRAddString

Статья
04/04/2023

Функция DDRAddString в Configuration Manager добавляет строковое свойство в запись обнаружения данных (DDR).

Синтаксис

[IDL]  
HRESULT DDRAddString();

Параметры

Name
Имя свойства класса.

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

nSQLWidth
Максимальная длина строки, которую можно назначить этому свойству. Это значение не включает символ NULL. Для SMS 2003 это значение не может превышать 900 символов. Для SMS 2.0 это значение не может превышать 255 символов.

Flags
Характеристики свойства, например ключевое поле для сравнений. Введите один или несколько следующих флагов или ноль.

Flag	Описание
ADDPROP_GUID (шестнадцатеричная 2)	Идентифицирует свойство, которое является постоянным и уникальным образом идентифицирует обнаруженный элемент. Если указано для системных DDR, это должен быть SMSID, созданный клиентом Configuration Manager. Этот флаг используется только для `SMSUniqueIdentifier` свойства . Если вы используете ADDPROP_GUID, необходимо также использовать ADDPROP_KEY. Обратите внимание, что `SMSUniqueIdentifier` данные обнаружения связаны с данными инвентаризации. Если данные инвентаризации для этого ресурса не собираются `SMSUniqueIdentifier`, указывать свойство в ddr не нужно.
ADDPROP_KEY (шестнадцатеричный 8)	Определяет это свойство в качестве ключевого поля при сравнении этой ddr-памяти с экземплярами класса в базе данных. Если экземпляр в базе данных соответствует данным свойств ключа DDR, экземпляр обновляется; В противном случае создается новый экземпляр.
ADDPROP_NAME (шестнадцатеричный 44)	Указывает диспетчеру обнаружения данных (DDM) использовать строковое значение этого свойства для значения `Name`свойства. Свойство `Name` является одним из шести дополнительных свойств, созданных DDM.
ADDPROP_NAME2 (шестнадцатеричная 84)	`Comment` Добавляет свойство в ddr и использует строковое значение свойства для его значения.

Возвращаемые значения

Если функция выполнена успешно, возвращаемое значение будет S_OK.

Если функция DDRNew не была вызвана, возвращаемое значение будет S_FALSE.

Замечания

Ddr должен содержать одно строковое свойство, указывающее флаг ADDPROP_NAME. Значение должно однозначно идентифицировать ресурс, Name так как свойство обычно используется для запроса данных ресурса.

Ddr отклоняется, если sValue длина превышает максимальную длину, указанную в nSQLWidth.

Для имен свойств, содержащих несколько слов, можно использовать знаки подчеркивания, объединения или пробелы. Например, можно указать sName как License_Number, LicenseNumberили LicenseNumber. Если указать sName как LicenseNumber, DDM объединяет слова, что приводит к LicenseNumber. Однако имя столбца, который создается в базе данных, имеет значение License_Number. При добавлении DDR, которые создают или обновляют экземпляры в существующем классе ресурсов, необходимо использовать то же соглашение.

Требования

Требования к среде выполнения

smsrsgenctl.dll

smsrsgen.dll

Дополнительные сведения см. в разделе Требования к среде выполнения сервера Configuration Manager.

Требования к разработке

Дополнительные сведения см. в разделе Требования к разработке сервера Configuration Manager.

См. также

DDRAddInteger
DDRAddStringArray
Перечисление DDRPropertyFlagsEnum
Класс автоматизации COM SMSResGen
Интерфейс ISMSResGen

Поделиться через