PropVariantGetInt32Elem 関数 (propvarutil.h)

VT_I4 型の PROPVARIANT から 1 つの Int32 要素を抽出VT_VECTOR |VT_I4、またはVT_ARRAY |VT_I4。

構文

PSSTDAPI PropVariantGetInt32Elem(
  [in]  REFPROPVARIANT propvar,
  [in]  ULONG          iElem,
  [out] LONG           *pnVal
);

パラメーター

[in] propvar

型: REFPROPVARIANT

ソース PROPVARIANT 構造体への参照。

[in] iElem

種類: ULONG

ベクターインデックスまたは配列インデックス。それ以外の場合、 iElem は 0 である必要があります。

[out] pnVal

種類: LONG*

この関数の場合、 には抽出された Int32 値が格納されます。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

解説

このヘルパー関数は、次の型の PROPVARIANT 構造体に対して機能します。

• VT_I4
• VT_VECTTOR |VT_I4
• VT_ARRAY |VT_I4

例

次の例では、この PropVariantGetInt32Elem を反復ステートメントと共に使用して 、PROPVARIANT 構造体の値にアクセスします。

// PROPVARIANT propvar;
// assume propvar is initialized and valid

if ((propvar.vt & VT_TYPEMASK) == VT_I4)
{
    UINT cElem = PropVariantGetElementCount(propvar);
    HRESULT hr = <mark type="const">S_OK</mark>;

    for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
    {
        LONG nValue;
        hr = PropVariantGetInt32Elem(propvar, iElem, &nValue);

        if (SUCCEEDED(hr))
        {
            // nValue is valid now
        }
    }
}

要件

関連項目

PropVariantGetElem