Fungsi MprAdminInterfaceDeviceGetInfo (mprapi.h)
MprAdminInterfaceDeviceGetInfo mengambil informasi tentang perangkat yang digunakan dalam antarmuka putar-nomor permintaan perute.
Sintaks
DWORD MprAdminInterfaceDeviceGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwIndex,
[in] DWORD dwLevel,
[out] LPBYTE *lplpBuffer
);
Parameter
[in] hMprServer
Tangani ke perute untuk menjalankan panggilan ini. Dapatkan handel ini dengan memanggil MprAdminServerConnect.
[in] hInterface
Tangani ke antarmuka. Dapatkan handel ini dari panggilan sebelumnya ke MprAdminInterfaceCreate, atau dengan memanggil MprAdminInterfaceEnum
[in] dwIndex
Menentukan indeks perangkat berbasis satu. Antarmuka putar-nomor permintaan multitaut menggunakan beberapa perangkat.
[in] dwLevel
Nilai DWORD yang menjelaskan format di mana informasi dikembalikan dalam parameter lplpBuffer . Nilai yang dapat diterima untuk dwLevel menyertakan 0 atau 1 seperti yang tercantum dalam tabel berikut.
Nilai | Format Struktur |
---|---|
0 | MPR_DEVICE_0 |
1 | MPR_DEVICE_1 |
[out] lplpBuffer
Setelah berhasil diselesaikan, penunjuk ke struktur MPR_DEVICE_0 atau MPR_DEVICE_1 . Parameter dwLevel menunjukkan jenis struktur. Bebaskan memori ini dengan memanggil MprAdminBufferFree.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
Nilai | Makna |
---|---|
|
Aplikasi panggilan tidak memiliki hak istimewa yang memadai. |
|
Nilai hInterface tidak valid. |
|
Parameter lplpbBuffer adalah NULL. |
|
Sumber daya tidak cukup untuk menyelesaikan operasi. |
|
Nilai dwLevel tidak valid. |
Persyaratan
Klien minimum yang didukung | Tidak ada yang didukung |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | mprapi.h |
Pustaka | Mprapi.lib |
DLL | Mprapi.dll |