Metode IOleUILinkContainerA::GetLinkSource (oledlg.h)

Artikel
03/01/2024

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

Sintaks

HRESULT GetLinkSource(
  [in]            DWORD dwLink,
  [out, optional] LPSTR *lplpszDisplayName,
  [out]           ULONG *lplenFileName,
  [out, optional] LPSTR *lplpszFullLinkType,
  [out, optional] LPSTR *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 penunjuk 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 di 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 adalah 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 untuk 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.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin 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

Persyaratan	Nilai
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