Metode CBaseDispatch.GetIDsOfNames
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]
Metode ini GetIDsOfNames memetakan sekumpulan nama ke sekumpulan DISPID yang sesuai.
Sintaks
HRESULT GetIDsOfNames(
REFIID riid,
OLECHAR **rgszNames,
UINT cNames,
LCID lcid,
DISPID *rgdispid
);
Parameter
-
riid
-
Referensi ke pengidentifikasi antarmuka (IID) yang menentukan antarmuka.
-
rgszNames
-
Alamat array string karakter lebar yang berisi nama yang akan dipetakan.
-
cNames
-
Ukuran array yang diberikan oleh parameter rgszNames .
-
Icid
-
Konteks lokal untuk menginterpretasikan nama. Bisa NULL.
-
rgdispid
-
Penunjuk ke array yang menerima DISPID. Setiap elemen menerima pengidentifikasi yang sesuai dengan salah satu nama yang diteruskan dalam parameter rgszNames .
Nilai kembali
Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Berhasil. |
|
Memori tidak cukup. |
|
Satu atau beberapa nama tidak diketahui. |
Keterangan
Metode ini ber perilaku seperti metode IDispatch::GetIDsOfNames , tetapi parameter riid menentukan antarmuka untuk mengambil DISPID. (Dalam versi IDispatch , parameter riid dicadangkan.)
Jika metode mengembalikan DISP_E_UNKNOWNNAME, DISPID yang dikembalikan berisi DISPID_UNKNOWN untuk setiap entri yang sesuai dengan nama yang tidak diketahui.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|