Fungsi InitVariantFromGUIDAsString (propvarutil.h)

Artikel
03/13/2024

Menginisialisasi struktur VARIAN berdasarkan GUID. Struktur diinisialisasi sebagai jenis VT_BSTR .

Sintaks

PSSTDAPI InitVariantFromGUIDAsString(
  [in]  REFGUID guid,
  [out] VARIANT *pvar
);

Parameter

[in] guid

Jenis: REFGUID

Referensi ke GUID sumber.

[out] pvar

Jenis: VARIAN*

Ketika fungsi ini kembali, berisi struktur VARIAN yang diinisialisasi.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Membuat varian VT_BSTR, memformat GUID dalam formulir yang mirip {c200e360-38c5-11ce-ae62-08002b2b79ef}dengan .

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan InitVariantFromGUIDAsString.

VARIANT var;

HRESULT hr = InitVariantFromGUIDAsString(FMTID_DocSummaryInformation, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_BSTR.
    VariantClear(&var);
}

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