propVariantToFileTime 函式 (propvarutil.h)
從 PROPVARIANT 結構擷取 FILETIME 結構。
語法
PSSTDAPI PropVariantToFileTime(
[in] REFPROPVARIANT propvar,
[in] PSTIME_FLAGS pstfOut,
[out] FILETIME *pftOut
);
參數
[in] propvar
類型： REFPROPVARIANT
來源 PROPVARIANT 結構的參考。
[in] pstfOut
類型： PSTIME_FLAGS
指定下列其中一個時間旗標。
PSTF_UTC (0)
表示輸出將使用國際標準時間。
PSTF_LOCAL (1)
表示輸出將使用當地時間。
[out] pftOut
類型： FILETIME*
當此函式傳回時，會包含擷取的 FILETIME 結構。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
此協助程式函式用於呼叫應用程式預期 PROPVARIANT 保留單一 filetime 值的位置。 例如，從屬性存放區取得值的應用程式可以使用這個來安全地擷取 filetime 屬性的 filetime 值。
如果來源 PROPVARIANT 的類型VT_FILETIME或VT_DATE，則此協助程式函式會使用 pstfOut 指定的時區，將值擷取為 FILETIME。 如果來源 PROPVARIANT VT_EMPTY或任何其他類型，則此函式會傳回失敗結果。
來源 PROPVARIANT 必須是國際標準時間 (UTC) 。 PSTF_UTC和PSTF_LOCAL旗標可讓呼叫的應用程式指定輸出應該轉換成的時區。
範例
下列範例要包含在較大的程式中，示範如何使用 PropVariantToFileTime 來存取 PROPVARIANT 中的 FILETIME 值。
// IPropertyStore *ppropstore;
// Assume variable ppropstore is initialized and valid
PROPVARIANT propvar = {0};
HRESULT hr = ppropstore->GetValue(PKEY_DateModified, &propvar);
if (SUCCEEDED(hr))
{
// PKEY_DateModified is expected to produce a VT_FILETIME or VT_EMPTY value.
// PropVariantToFileTime will return a failure code for VT_EMPTY
FILETIME ftModified;
hr = PropVariantToFileTime(propvar, PSTF_UTC, &ftModified);
if (SUCCEEDED(hr))
{
// ftModified is now valid and contains a file time in UTC
}
else
{
// Unable to convert propvar to a FILETIME
}
PropVariantClear(&propvar);
}
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 SP1 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | propvarutil.h |
| 程式庫 | Propsys.lib |
| Dll | Propsys.dll (6.0 版或更新版本) |
| 可轉散發套件 | Windows 桌面搜尋 (WDS) 3.0 |