Metode ISpecifyPropertyPages::GetPages (ocidl.h)
Mengambil daftar halaman properti yang bisa ditampilkan di lembar properti objek ini.
Sintaks
HRESULT GetPages(
[out] CAUUID *pPages
);
Parameter
[out] pPages
Penunjuk ke struktur CAUUID yang dialokasikan penelepon yang diinisialisasi dan diisi fungsi sebelum kembali. Anggota pElems dalam struktur dialokasikan oleh fungsi dengan CoTaskMemAlloc, dan harus dibebaskan oleh pemanggil dengan CoTaskMemFree.
Nilai kembali
Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY dan E_UNEXPECTED, serta nilai berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Metode berhasil diselesaikan. |
|
Alamat di pPages tidak valid. Misalnya, mungkin NULL. |
Keterangan
Struktur CAUUID dialokasikan pemanggil, tetapi tidak diinisialisasi oleh pemanggil. Metode GetPages mengisi anggota cElements dalam struktur. Metode ini juga mengalokasikan memori untuk array yang diarahkan oleh anggota pElems menggunakan CoTaskMemAlloc. Kemudian, ia mengisi array yang baru dialokasikan. Setelah metode ini berhasil dikembalikan, struktur berisi array UUID yang dihitung, setiap UUID yang menentukan halaman properti CLSID.
Catatan untuk Penelepon
Pemanggil harus melepaskan memori yang diacu oleh anggota pElemsCAUUID, menggunakan CoTaskMemFree ketika tidak lagi diperlukan.Catatan untuk Pelaksana
E_NOTIMPL tidak diizinkan sebagai nilai pengembalian, karena objek tanpa halaman properti tidak boleh mengekspos antarmuka ISpecifyPropertyPages .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 | ocidl.h |