DDRAddString

DDRAddString Configuration Manager 中的函式會將字串屬性新增至 DDR) (資料探索記錄。

語法

[IDL]  
HRESULT DDRAddString();  

參數

Name
類別屬性的名稱。

sValue
指派給 屬性的值。 您只能輸入來自單一位元組字元集的字串值。

nSQLWidth
可以指派給這個屬性的字串長度上限。 此值不包含NULL字元。 針對SMS 2003，此值不能大於900個字元。 針對SMS 2.0，此值不能大於255個字元。

Flags
屬性的特性，例如用於比較的索引鍵欄位。 輸入下列一或多個旗標或零。

國旗	描述
ADDPROP_GUID (十六进制 2)	識別常數的屬性，並唯一識別探索到的專案。 如果為系統 DDR 指定，這應該是 Configuration Manager 用戶端所產生的SMSID。 此旗標僅用於 SMSUniqueIdentifier 屬性。 如果您使用 ADDPROP_GUID，則也必須使用 ADDPROP_KEY。 SMSUniqueIdentifier 將探索數據與清查數據相關聯。 如果您未收集此資源的清查資訊，則不需要在 DDR 中指定 SMSUniqueIdentifier屬性。
ADDPROP_KEY (十六进制 8)	在此 DDR 與資料庫中的類別實例比較期間，將這個屬性識別為索引鍵欄位。 如果資料庫中的實例符合 DDR 索引鍵屬性的數據，則會更新實例;否則會建立新的 實例。
ADDPROP_NAME (十六进制 44)	告知 Data Discovery Manager (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 伺服器開發需求。

另請參閱

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum 列舉
SMSResGen COM 自動化類別
ISMSResGen 介面