Metode IOleUILinkContainerA::SetLinkSource (oledlg.h)

Artikel
08/25/2023

Mengubah sumber tautan.

Sintaks

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR lpszDisplayName,
  [in]  ULONG lenFileName,
  [out] ULONG *pchEaten,
  [in]  BOOL  fValidateSource
);

Parameter

[in] dwLink

Pengidentifikasi unik yang ditentukan kontainer untuk satu tautan. Lihat IOleUILinkContainer::GetNextLink.

[in] lpszDisplayName

Arahkan ke string sumber baru yang akan diurai.

[in] lenFileName

Panjang bagian nama file terkemuka dari string lpszDisplayName . Jika sumber tautan tidak disimpan dalam file, maka lenFileName harus 0. Untuk tautan OLE, panggil IOleLink::GetSourceDisplayName.

[out] pchEaten

Penunjuk ke jumlah karakter yang berhasil diurai dalam lpszDisplayName.

[in] fValidateSource

TRUE jika moniker harus divalidasi; untuk tautan OLE, MkParseDisplayName harus dipanggil. FALSE jika moniker tidak boleh divalidasi. Jika memungkinkan, tautan harus menerima sumber yang tidak valid, dan menandai dirinya sebagai tidak tersedia.

Menampilkan nilai

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_ACCESSDENIED	Izin akses tidak cukup.
E_FAIL	Operasi gagal.
E_INVALIDARG	Pengidentifikasi yang disediakan tidak valid.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk operasi ini.

Keterangan

Catatan untuk Penelepon

Panggil metode ini dari kotak dialog Ubah Sumber , dengan fValidateSource awalnya diatur ke TRUE. Ubah Sumber dapat dipanggil secara langsung atau dari kotak dialog Tautan . Jika panggilan ke IOleUILinkContainer::SetLinkSource ini mengembalikan kesalahan (misalnya, MkParseDisplayName gagal karena sumber tidak tersedia), maka Anda harus menampilkan pesan Sumber Tautan Tidak Valid , dan pengguna harus diizinkan untuk memutuskan apakah akan memperbaiki sumber. Jika pengguna memilih untuk memperbaiki sumber, maka pengguna harus dikembalikan ke kotak dialog Ubah Sumber dengan bagian string input yang tidak valid disorot. Jika pengguna memilih untuk tidak memperbaiki sumbernya, maka IOleUILinkContainer::SetLinkSource harus dipanggil untuk kedua kalinya dengan fValidateSource diatur ke FALSE, dan pengguna harus dikembalikan ke kotak dialog Tautan dengan tautan bertanda Tidak Tersedia.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oledlg.h

Lihat juga

IOleUILinkContainer

MkParseDisplayName