IOleUIObjInfoW::Metode GetObjectInfo (oledlg.h)

Artikel
03/01/2024

Mendapatkan informasi ukuran, jenis, nama, dan lokasi untuk objek.

Sintaks

HRESULT GetObjectInfo(
  [in]            DWORD  dwObject,
  [out]           DWORD  *lpdwObjSize,
  [out, optional] LPWSTR *lplpszLabel,
  [out, optional] LPWSTR *lplpszType,
  [out, optional] LPWSTR *lplpszShortType,
  [out, optional] LPWSTR *lplpszLocation
);

Parameter

[in] dwObject

Pengidentifikasi unik untuk objek.

[out] lpdwObjSize

Arahkan ke ukuran objek, dalam byte, pada disk. Ini mungkin nilai perkiraan.

[out, optional] lplpszLabel

Alamat variabel pointer yang menerima penunjuk ke string label objek. Parameter ini mungkin NULL untuk menunjukkan bahwa implementasi tidak boleh mengembalikan string label.

[out, optional] lplpszType

Alamat variabel pointer yang menerima penunjuk ke string jenis panjang objek. Parameter ini mungkin NULL untuk menunjukkan bahwa implementasi tidak boleh mengembalikan string jenis panjang.

[out, optional] lplpszShortType

Alamat variabel penunjuk yang menerima penunjuk ke string jenis pendek objek. Parameter ini mungkin NULL untuk menunjukkan bahwa implementasi tidak boleh mengembalikan string jenis pendek.

[out, optional] lplpszLocation

Alamat variabel pointer yang menerima penunjuk ke string lokasi sumber objek. Parameter ini mungkin NULL untuk menunjukkan bahwa implementasi tidak boleh mengembalikan string lokasi.

Menampilkan nilai

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

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

Keterangan

String dan ukuran objek ditampilkan di halaman Umum properti objek.

Catatan untuk Pelaksana

Implementasi GetObjectInfo Anda harus menempatkan setiap atribut objek dalam parameter keluar yang disediakan. Atur lpdwObjSize ke (DWORD)-1 saat ukuran objek tidak diketahui. Alokasikan semua string (sisa param) dengan alokator tugas OLE yang diperoleh melalui CoGetMalloc, seperti halnya standar untuk semua antarmuka OLE dengan parameter string [out], atau Anda cukup menggunakan CoTaskMemAlloc.

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

Lihat juga

CoGetMalloc

CoTaskMemAlloc

IOleUIObjInfo

Bagikan melalui