Configuration Manager の DDRAddString 関数は、データ探索レコード (DDR) に文字列プロパティを追加します。
構文
[IDL]
HRESULT DDRAddString();
パラメーター
Name クラス プロパティの名前。
sValue プロパティに割り当てられている値。 1 バイト文字セットからの文字列値のみを入力できます。
nSQLWidth このプロパティに割り当てることができる文字列の最大長。 この値に NULL 文字は含まれません。 SMS 2003 の場合、この値は 900 文字より大きくする必要があります。 SMS 2.0 の場合、この値は 255 文字より大きくすることはできません。
Flags プロパティの特性 (比較のキー フィールドなど)。 次のフラグを 1 つ以上入力するか、ゼロを入力します。
| Flag | 説明 |
|---|---|
| ADDPROP_GUID (16 進数 2) | 定数で、検出された項目を一意に識別するプロパティを示します。 システム DDRs に指定する場合、これは Configuration Manager クライアントによって生成された SMSID である必要があります。 このフラグは、 SMSUniqueIdentifier プロパティでのみ使用されます。 ADDPROP_GUID を使用する場合は、ADDPROP_KEY も使用する必要があります。SMSUniqueIdentifier 検出データをインベントリ データに関連付けます。 このリソースのインベントリ情報を収集しない場合は、DDR で SMSUniqueIdentifierproperty を指定する必要はありません。 |
| ADDPROP_KEY (16 進 8) | この DDR とデータベース内のクラス インスタンスを比較するときに、このプロパティをキー フィールドとして識別します。 データベース内のインスタンスがDDRキープロパティのデータと一致する場合、インスタンスは更新されます。それ以外の場合は、新しいインスタンスが作成されます。 |
| ADDPROP_NAME (16 進数 44) | このプロパティの文字列値を Nameプロパティの値として使用するようにデータ探索マネージャー (DDM) に指示します。Name プロパティは、DDM によって生成される他の 6 つのプロパティの 1 つです。 |
| ADDPROP_NAME2 (16 進 84) |
Comment プロパティを DDR に追加し、プロパティの文字列値をその値として使用します。 |
戻り値
関数が成功した場合、戻り値は S_OK です。
DDRNew 関数が呼び出されていない場合、戻り値は S_FALSE です。
注釈
DDR には、ADDPROP_NAME フラグを指定する文字列プロパティが 1 つ含まれている必要があります。 通常、 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 インターフェイス