DDRAddString Configuration Manager 中的 函数向数据发现记录添加字符串属性， (DDR) 。
语法
[IDL]
HRESULT DDRAddString();
参数
Name 类属性的名称。
sValue 分配给 属性的值。 只能输入单字节字符集中的字符串值。
nSQLWidth 可分配给此属性的字符串的最大长度。 此值不包括 NULL 字符。 对于 SMS 2003，此值不能大于 900 个字符。 对于 SMS 2.0，此值不能大于 255 个字符。
Flags 属性的特征，例如用于比较的键字段。 输入以下一个或多个标志或零。
| Flag | 说明 |
|---|---|
| ADDPROP_GUID (十六进制 2) | 标识一个属性，该属性是常量且唯一标识发现的项。 如果为系统 DDR 指定，则应为Configuration Manager客户端生成的 SMSID。 此标志仅用于 SMSUniqueIdentifier 属性。 如果使用 ADDPROP_GUID，还必须使用 ADDPROP_KEY。SMSUniqueIdentifier 将发现数据与清单数据关联。 如果不收集此资源的清单信息，则无需在 DDR 中指定 SMSUniqueIdentifier属性。 |
| 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 因为 属性通常用于查询资源数据。
如果 sValue 长于 中指定的 nSQLWidth最大长度，则拒绝 DDR。
可以对包含多个字词的属性名称使用下划线、串联或空格。 例如，可以将 指定 sName 为 License_Number、 LicenseNumber或 LicenseNumber。 如果将 指定 sName 为 LicenseNumber，则 DDM 会连接单词，从而生成 LicenseNumber。 但是，在数据库中创建的列名是 License_Number。 添加在现有资源类中创建或更新实例的 DDR 时，必须使用相同的约定。
要求
运行时要求
smsrsgenctl.dll
smsrsgen.dll
有关详细信息，请参阅Configuration Manager服务器运行时要求。
开发要求
有关详细信息，请参阅Configuration Manager服务器开发要求。
另请参阅
DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum 枚举SMSResGen COM 自动化类ISMSResGen 接口