PropVariantToInt64 関数 (propvarutil.h)

PROPVARIANT 構造体から LONGLONG 値を抽出します。 値を抽出できない場合は、既定値が割り当てられます。

構文

PSSTDAPI PropVariantToInt64(
  [in]  REFPROPVARIANT propvarIn,
  [out] LONGLONG       *pllRet
);

パラメーター

[in] propvarIn

型: REFPROPVARIANT

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

[out] pllRet

種類: LONGLONG*

この関数が戻るとき、 には抽出されたプロパティ値 (存在する場合) が格納されます。それ以外の場合は 0。

戻り値

種類: HRESULT

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

注釈

このヘルパー関数は、呼び出し元のアプリケーションが PROPVARIANT で LONGLONG 値を保持することを想定している場所で使用されます。 たとえば、プロパティ ストアから値を取得するアプリケーションでは、これを使用して Int64 プロパティの LONGLONG 値を安全に抽出できます。

ソース PROPVARIANT に 型VT_I8がある場合、このヘルパー関数は LONGLONG 値を抽出します。 それ以外の場合は、 PROPVARIANT 構造体の値を LONGLONG に変換しようとします。 変換できない場合、 PropVariantToInt64 はエラー コードを返し、 pllRet を 0 に設定します。 可能な変換の一覧については、「 PropVariantChangeType 」を参照してください。 特に、 VT_EMPTY は正常に 0 に変換されます。

例

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
LONGLONG llValue; // The application is expecting propvar to hold a VT_I8 value
HRESULT hr = PropVariantToInt64(propvar, &llValue);
if (SUCCEEDED(hr))
{
     // llValue is valid
}                    
else
{
         // the extraction failed
}

要件

こちらもご覧ください

InitPropVariantFromInt64

PropVariantChangeType

PropVariantToInt64Vector

VariantToInt64