Fungsi InitVariantFromString (propvarutil.h)

Menginisialisasi struktur VARIAN dengan string.

Sintaks

HRESULT InitVariantFromString(
  [in]  PCWSTR  psz,
  [out] VARIANT *pvar
);

Parameter

[in] psz

Jenis: PCWSTR

Penunjuk ke buffer yang berisi string Unicode sumber. Jika nilai ini ADALAH NULL, fungsi menginisialisasi VARIAN dengan NULLBSTR.

[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.

Ini adalah fungsi sebaris, dengan kode sumbernya disediakan di header . Ini tidak termasuk dalam file .dll atau .lib.

Contoh

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

VARIANT var;

HRESULT hr = InitVariantFromString(L"This is a test", &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
DLL	Propsys.dll (versi 6.0 atau yang lebih baru)
Redistribusi	Windows Desktop Search (WDS) 3.0

Lihat juga

InitPropVariantFromString

InitVariantFromStringArray

VariantToString

VariantToStringWithDefault