Metode IOleUILinkContainerW::GetLinkSource (oledlg.h)

Artikel
08/25/2023

Mengambil informasi tentang tautan yang bisa ditampilkan dalam kotak dialog Tautan .

Sintaks

HRESULT GetLinkSource(
  [in]            DWORD  dwLink,
  [out, optional] LPWSTR *lplpszDisplayName,
  [out]           ULONG  *lplenFileName,
  [out, optional] LPWSTR *lplpszFullLinkType,
  [out, optional] LPWSTR *lplpszShortLinkType,
  [out]           BOOL   *lpfSourceAvailable,
  [out]           BOOL   *lpfIsSelected
);

Parameter

[in] dwLink

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

[out, optional] lplpszDisplayName

Alamat variabel pointer yang menerima penunjuk ke string nama tampilan lengkap untuk sumber tautan. Kotak dialog Tautan akan membebaskan string ini.

[out] lplenFileName

Penunjuk ke panjang bagian nama file terkemuka dari string lplpszDisplayName . Jika sumber tautan tidak disimpan dalam file, maka lplenFileName harus 0. Untuk tautan OLE, panggil IOleLink::GetSourceDisplayName.

[out, optional] lplpszFullLinkType

Alamat variabel penunjuk yang menerima penunjuk ke string jenis tautan lengkap yang ditampilkan di bagian bawah kotak dialog Tautan . Penelepon mengalokasikan string ini. Kotak dialog Tautan akan membebaskan string ini. Untuk tautan OLE, ini harus menjadi nama Jenis Pengguna lengkap. Gunakan IOleObject::GetUserType, menentukan USERCLASSTYPE_FULL untuk dwFormOfType.

[out, optional] lplpszShortLinkType

Alamat variabel penunjuk yang menerima penunjuk ke string jenis tautan pendek yang ditampilkan dalam kotak daftar kotak dialog Tautan . Penelepon mengalokasikan string ini. Kotak dialog Tautan akan membebaskan string ini. Untuk tautan OLE, ini harus menjadi nama jenis pengguna pendek. Gunakan IOleObject::GetUserType, menentukan USERCLASSTYPE_SHORT untuk dwFormOfType.

[out] lpfSourceAvailable

Penunjuk yang mengembalikan FALSE jika diketahui bahwa tautan tidak tersedia karena tautan ke beberapa dokumen yang diketahui tetapi tidak tersedia. Opsi tertentu, seperti Perbarui Sekarang, dinonaktifkan (berwarna abu-abu di antarmuka pengguna) untuk kasus tersebut.

[out] lpfIsSelected

Penunjuk ke variabel yang memberi tahu kotak dialog Edit Tautan bahwa entri tautan ini harus dipilih dalam kotak daftar multi-pilihan dialog. OleUIEditLinks memanggil metode ini setidaknya sekali agar setiap item ditempatkan dalam daftar tautan. Jika tidak ada yang mengembalikan TRUE, maka tidak ada yang akan dipilih saat kotak dialog pertama kali ditampilkan. Jika semuanya mengembalikan TRUE, maka semua akan ditampilkan. Artinya, ini mengembalikan TRUE jika tautan ini saat ini merupakan bagian dari pilihan dalam dokumen yang mendasar, FALSE jika tidak. Tautan apa pun yang dipilih dalam dokumen yang mendasar dipilih dalam kotak dialog; dengan cara ini, pengguna dapat memilih sekumpulan tautan dan menggunakan kotak dialog untuk memperbaruinya atau mengubah sumbernya secara bersamaan.

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 ditentukan tidak valid.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk operasi ini.

Keterangan

Catatan untuk Penelepon

Panggil metode ini selama inisialisasi kotak dialog, setelah kembali dari kotak dialog Ubah Sumber .

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