Fungsi PropVariantToGUID (propvarutil.h)
Mengekstrak nilai GUID dari struktur PROPVARIANT .
Sintaks
PSSTDAPI PropVariantToGUID(
[in] REFPROPVARIANT propvar,
[out] GUID *pguid
);
Parameter
[in] propvar
Jenis: REFPROPVARIANT
Referensi ke struktur PROPVARIANT sumber.
[out] pguid
Jenis: GUID*
Ketika fungsi ini kembali, berisi nilai properti yang diekstrak jika ada.
Nilai kembali
Jenis: HRESULT
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Fungsi pembantu ini berfungsi untuk strukturPROPVARIANT dari jenis berikut:
- VT_GUID
- VT_BSTR
- VT_LPWSTR
- VT_ARRAY | VT_UI1
PropVariantToGUID digunakan di tempat-tempat di mana aplikasi panggilan mengharapkan PROPVARIANT untuk menyimpan satu nilai GUID atau GUID . Misalnya, aplikasi yang mendapatkan nilai dari penyimpanan properti dapat menggunakan ini untuk mengekstrak nilai GUID dengan aman untuk properti GUID .
Contoh
// IPropertyStore *ppropstore;
// Assume variable ppropstore is initialized and valid
PROPVARIANT propvar = {0};
HRESULT hr = ppropstore->GetValue(PKEY_Sync_HandlerCollectionID, &propvar);
if (SUCCEEDED(hr))
{
// PKEY_Sync_HandlerCollectionID is expected to produce a VT_CLSID or VT_EMPTY value.
// PropVariantToGUID will convert VT_EMPTY to a failure code.
GUID guidCollectionID;
hr = PropVariantToGUID(propvar, &guidCollectionID);
if (SUCCEEDED(hr))
{
// guidCollectionID is now valid
}
else
{
// the extraction failed
}
PropVariantClear(&propvar);
}
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP dengan SP2, Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 dengan SP1 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | propvarutil.h |
Pustaka | Propsys.lib |
DLL | Propsys.dll (versi 6.0 atau yang lebih baru) |
Redistribusi | Windows Desktop Search (WDS) 3.0 |