fungsi PifMgr_GetProperties (shlobj_core.h)
[PifMgr_GetProperties tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]
Mengembalikan blok data tertentu dari file .pif.
Sintaks
int PifMgr_GetProperties(
[in, optional] HANDLE hProps,
[in, optional] PCSTR pszGroup,
[out, optional] void *lpProps,
int cbProps,
UINT flOpt
);
Parameter
[in, optional] hProps
Jenis: HANDEL
Handel ke properti aplikasi. Parameter ini harus diatur ke nilai yang dikembalikan oleh PifMgr_OpenProperties.
[in, optional] pszGroup
Jenis: PCSTR
String yang dihentikan null yang berisi nama grup properti. Ini bisa menjadi salah satu dari berikut ini, atau nama lain yang sesuai dengan ekstensi .pif yang valid.
"WINDOWS 286 3.0"
"WINDOWS 386 3.0"
"WINDOWS VMM 4.0"
"WINDOWS NT 3.1"
"WINDOWS NT 4.0"
[out, optional] lpProps
Jenis: batal*
Ketika fungsi ini kembali, berisi penunjuk ke struktur PROPPRG .
cbProps
Jenis: int
Ukuran buffer, dalam byte, ditujukkan oleh lpProps.
flOpt
Jenis: UINT
Atur parameter ini ke GETPROPS_NONE.
Nilai kembali
Jenis: int
Mengembalikan NULL jika berhasil. Jika tidak berhasil, fungsi mengembalikan handel ke properti aplikasi yang diteruskan sebagai hProps.
Keterangan
Jika blok adalah blok "bernama", blok tersebut harus berupa nama ekstensi yang ditautkan di dalam file .pif. Ini bisa berupa nama yang telah ditentukan sebelumnya (seperti, "WINDOWS 386 3.0") atau nama blok Anda sendiri. Anda dapat membuat blok data bernama Anda sendiri menggunakan PifMgr_SetProperties. Data bernama juga dapat dianggap sebagai data mentah, karena dikembalikan ke aplikasi panggilan apa adanya, tanpa terjemahan.
Ukuran blok bernama dapat ditentukan dengan memanggil PifMgr_GetProperties dengan cbProps diatur ke 0. Tidak ada data yang disalin, tetapi ukuran blok yang diminta dikembalikan.
Semua blok bernama dapat dijumlahkan dengan mengatur pszGroup ke NULL. lpProps harus menjadi penunjuk ke buffer 16 byte untuk berisi nama blok yang diminta, dan cbProps harus diatur ke indeks blok berbasis nol. Nilai yang dikembalikan adalah ukuran blok, atau nol jika blok tidak ditemukan.
Jika Anda meminta blok properti yang tidak disebutkan namanya dengan mengatur pemilih parameter nama ke NULL, dan offset adalah grup properti ordinal, maka struktur terkait dikembalikan. Misalnya, PifMgr_GetProperties(GROUP_TSK) mengembalikan struktur yang telah ditentukan sebelumnya yang berisi semua informasi terkait tugas dalam format yang independen dari file .pif. Ini adalah layanan berharga karena meringankan aplikasi panggilan dari berurusan dengan file .pif yang berisi berbagai bagian (dikenal sebagai ekstensi .pif), ketika hanya satu yang diperlukan.
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 | shlobj_core.h |
| Pustaka | Shell32.lib |
| DLL | Shell32.dll (versi 5.0 atau yang lebih baru) |