共用方式為

PropVariantToFileTimeVector 函式 (propvarutil.h)

  • 發行項

將數據從 PROPVARIANT 結構擷取至 FILETIME 向量。

語法

PSSTDAPI PropVariantToFileTimeVector(
  [in]  REFPROPVARIANT propvar,
  [out] FILETIME       *prgft,
  [in]  ULONG          crgft,
  [out] ULONG          *pcElem
);

參數

[in] propvar

類型： REFPROPVARIANT

來源 PROPVARIANT 結構的參考。

[out] prgft

類型： FILETIME*

指向包含 crgft FILETIME 值的緩衝區。 當此函式傳回時，緩衝區已使用從來源 PROPVARIANT 結構擷取的pcElem FILETIME元素初始化。

[in] crgft

類型： ULONG

prgft 所指向之緩衝區元素的大小。

[out] pcElem

類型： ULONG*

當此函式傳回時，包含從來源 PROPVARIANT 結構擷取的 FILETIME 元素計數。

傳回值

類型： HRESULT

傳回下列其中一個值。

傳回碼 描述
S_OK
 如果成功，則傳回 S_OK ，否則傳回錯誤值。
TYPE_E_BUFFERTOOSMALL
 來源 PROPVARIANT 包含超過crgn值。 prgft 所指向的緩衝區。
E_INVALIDARG
 PROPVARIANT 不是適當的類型。

備註

這個協助程式函式用於呼叫應用程式預期 PROPVARIANT 以固定項目數目保存 filetime 向量值的位置。

如果來源 PROPVARIANT 的類型為 VT_VECTOR |VT_FILETIME，這個協助程式函式會擷取最多 crgft FILETIME 值，並將其放入 prgft 所指向的緩衝區中。 如果 PROPVARIANT 包含的項目超過將放入 prgft 緩衝區中，則此函式會傳回錯誤，並將 pcElem 設定為 0。

輸出 FILETIME 將使用與來源 FILETIME 相同的時區。

範例

下列範例要包含在較大的程式中，示範如何使用 PropVariantToFileTimeVector 來存取 PROPVARIANT 中的 FILETIME 向量值。

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
FILETIME rgTimes[4]; // The application is expecting propvar to hold 4 FILETIMEs in a vector
ULONG cTimes;
HRESULT hr = PropVariantToFileTimeVector(propvar, rgTime, ARRAYSIZE(rgTime), &cTimes);
if (SUCCEEDED(hr))
{
     if (cTimes == ARRAYSIZE(rgTime))
     {
         // The application got 4 FILETIMEs which are now stored in rgTime
     }
     else
     {
         // The application got cTimes which are stored in the first cTimes elements of rgTime
     }
}

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 propvarutil.h
程式庫 Propsys.lib
Dll Propsys.dll (6.0 版或更新版本)
可轉散發套件 Windows 桌面搜尋 (WDS) 3.0

另請參閱

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVectorAlloc