IPortableDevicePropVariantCollection::Add メソッド
Add メソッドは、コレクションに項目を追加します。
構文
HRESULT Add(
[in] const PROPVARIANT *pValue
);
パラメーター
-
pValue [in]
-
コレクションに追加する新しい PROPVARIANT オブジェクトへのポインター。 このメソッドは PROPVARIANT をコレクションにコピーするため、このメソッドを呼び出した後に PropVariantClear を呼び出して、変数のローカル コピーを解放する必要があります。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
解説
pValue の VARTYPE がVT_VECTORまたはVT_UI1の場合、NULL または 0 サイズのバッファーの設定と取得はサポートされていません。 たとえば、pValue.caub.pElems = NULL も pValue.caub.cElems = 0 も許可されません。
呼び出し元がコレクションに含まれる別の VARTYPE の項目を追加しようとして、このインターフェイスで PROPVARIANT 値を自動的に変更できない場合、このメソッドは失敗します。 コレクションの種類を手動で変更するには、 IPortableDevicePropVariantCollection::ChangeType を呼び出します。
例
このメソッドの使用方法の例については、「永続的な一意識別子からのオブジェクト識別子の取得」を参照してください。
必要条件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|