DDRAddString

[アーティクル]
04/04/2023

関数は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)	プロパティの値にこのプロパティの文字列値を使用するように Data Discovery Manager (DDM) に `Name`指示します。プロパティは `Name` 、DDM によって生成される 6 つの追加プロパティのいずれかです。
ADDPROP_NAME2 (16 進数 84)	`Comment` DDR にプロパティを追加し、その値にプロパティの文字列値を使用します。

戻り値

関数が成功した場合、戻り値はS_OK。

DDRNew 関数が呼び出されていない場合、戻り値はS_FALSE。

注釈

DDR には、ADDPROP_NAME フラグを指定する 1 つの文字列プロパティが含まれている必要があります。プロパティは通常、リソースデータのクエリに使用されるため Name 、値はリソースを一意に識別する必要があります。

で指定された最大長より長い場合 sValue 、DDR は拒否されます nSQLWidth。

複数の単語を含むプロパティ名には、アンダースコア、連結、またはスペースを使用できます。たとえば、または LicenseNumberとしてLicense_NumberLicenseNumber指定sNameできます。をとしてLicenseNumber指定sNameすると、DDM によって単語が連結され、結果LicenseNumberとしてになります。ただし、データベースに作成される列名はです License_Number。既存のリソースクラスでインスタンスを作成または更新する DDR を追加する場合も、同じ規則を使用する必要があります。

要件

ランタイム要件

smsrsgenctl.dll

smsrsgen.dll

詳細については、「Configuration Manager サーバーランタイム要件」を参照してください。

開発要件

詳細については、「Configuration Manager サーバー開発要件」を参照してください。

次の方法で共有

DDRAddString

構文

パラメーター

戻り値

注釈

要件

ランタイム要件

開発要件

関連項目

フィードバック

その他のリソース