DDRAddString関数は、Configuration Managerで、データ探索レコード (DDR) に文字列プロパティを追加します。
構文
[IDL]
HRESULT DDRAddString();
パラメーター
Name クラス プロパティの名前。
sValue プロパティに割り当てられた値。 文字列値は、1 バイト文字セットからのみ入力できます。
nSQLWidth このプロパティに割り当てることができる文字列の最大長。 この値には NULL 文字は含まれません。 SMS 2003 の場合、この値は 900 文字を超えることはできません。 SMS 2.0 の場合、この値は 255 文字を超えることはできません。
Flags 比較のキー フィールドなど、プロパティの特性。 次のフラグの 1 つ以上を入力するか、0 を入力します。
| Flag | 説明 |
|---|---|
| ADDPROP_GUID (16 進数 2) | 定数であり、検出された項目を一意に識別するプロパティを識別します。 システム DDR に指定する場合、これは、Configuration Manager クライアントによって生成された SMSID である必要があります。 このフラグは、 SMSUniqueIdentifier プロパティでのみ使用されます。 ADDPROP_GUIDを使用する場合は、ADDPROP_KEYも使用する必要があります。SMSUniqueIdentifier は、検出データをインベントリ データに関連付ける。 このリソースのインベントリ情報を収集しない場合は、DDR で SMSUniqueIdentifierプロパティを指定する必要はありません。 |
| ADDPROP_KEY (16 進数 8) | この DDR をデータベース内のクラス インスタンスと比較する際に、このプロパティをキー フィールドとして識別します。 データベース内のインスタンスが DDR キー プロパティのデータと一致する場合、インスタンスは更新されます。それ以外の場合は、新しいインスタンスが作成されます。 |
| ADDPROP_NAME (16 進数 44) |
Nameプロパティの値に対してこのプロパティの文字列値を使用するように Data Discovery Manager (DDM) に指示します。Name プロパティは、DDM によって生成される他の 6 つのプロパティのいずれかです。 |
| ADDPROP_NAME2 (16 進数 84) |
Comment プロパティを DDR に追加し、その値にプロパティの文字列値を使用します。 |
戻り値
関数が成功した場合、戻り値はS_OK。
DDRNew 関数が呼び出されていない場合、戻り値はS_FALSE。
解説
DDR には、ADDPROP_NAME フラグを指定する 1 つの文字列プロパティが含まれている必要があります。
Name プロパティは通常、リソース データのクエリに使用されるため、値はリソースを一意に識別する必要があります。
sValueがnSQLWidthで指定された最大長を超える場合、DDR は拒否されます。
複数の単語を含むプロパティ名には、アンダースコア、連結、またはスペースを使用できます。 たとえば、License_Number、LicenseNumber、またはLicenseNumberとしてsNameを指定できます。
sNameをLicenseNumberとして指定すると、DDM によって単語が連結され、結果としてLicenseNumberされます。 ただし、データベースに作成される列名は License_Number。 既存のリソース クラスでインスタンスを作成または更新する DDR を追加する場合も、同じ規則を使用する必要があります。
要件
ランタイム要件
smsrsgenctl.dll
smsrsgen.dll
詳細については、「Configuration Manager サーバーランタイム要件」を参照してください。
開発要件
詳細については、「Configuration Manager サーバー開発要件」を参照してください。
関連項目
DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum 列挙SMSResGen COM オートメーション クラスISMSResGen インターフェイス