Metode IOleUIObjInfoA::GetObjectInfo (oledlg.h)
Mendapatkan informasi ukuran, jenis, nama, dan lokasi untuk objek.
Sintaks
HRESULT GetObjectInfo(
[in] DWORD dwObject,
[out] DWORD *lpdwObjSize,
[out, optional] LPSTR *lplpszLabel,
[out, optional] LPSTR *lplpszType,
[out, optional] LPSTR *lplpszShortType,
[out, optional] LPSTR *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.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Operasi gagal. |
|
Pengidentifikasi yang ditentukan tidak valid. |
|
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 |