Share via

SWbemPropertySet.Add メソッド

  • [アーティクル]

SWbemPropertySet オブジェクトの Add メソッドでは、SWbemPropertySet コレクションに SWbemProperty オブジェクトを追加します。 同じ名前のプロパティがコレクションに既に存在する場合、その内容は新しい定義に置き換えられます。

注意

この操作の後、追加されたプロパティの値は NULL (未割り当て) です。 WMI プロパティの値を設定または変更するには、返される SWbemProperty オブジェクトの Value プロパティを設定する必要があります。

この構文の説明については、スクリプト API のドキュメント規則に関する記事を参照してください。

構文

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

パラメーター

strName [in]

必須。 新しいプロパティの名前。

iCIMType [in]

必須。 新しいプロパティの CIMType 修飾子を表す整数。 CIMType 修飾子とその値を含む一覧については、「WbemCimTypeEnum」を参照してください。

bIsArray [in, 省略可能]

プロパティが配列型かどうかを指定します。 このパラメータの既定値は、FALSE です。

iFlags [in、省略可能]

予約済みで、指定する場合は 0 にする必要があります。

戻り値

成功した場合、このメソッドからは、新しいプロパティを表す SWbemProperty オブジェクトが返されます。 それ以外の場合は、null オブジェクトが返されます。

エラー コード

Add メソッドが完了すると、Err オブジェクトに次のいずれかのエラー コードが含まれる場合があります。

wbemErrFailed - 2147749889 (0x80041001)

不特定のエラー。

wbemErrInvalidParameter - 2147749896 (0x80041008)

無効なパラメーターが指定されました。

wbemErrOutOfMemory - 2147749894 (0x80041006)

このメソッドを実行するのに十分なメモリがありません。

wbemErrInvalidPropertyType - 2147749930

CIMType 修飾子が認識されていません。

例

このメソッドを使用するコード例については、SWbemPropertySet に関するトピックを参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
Header
Wbemdisp.h
タイプ ライブラリ
Wbemdisp.tlb
[DLL]
Wbemdisp.dll
CLSID
 CLSID_SWbemPropertySet
IID
 IID_ISWbemPropertySet

関連項目

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value