Fungsi MprAdminInterfaceDeviceGetInfo (mprapi.h)

Artikel
03/15/2023

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
ERROR_ACCESS_DENIED	Aplikasi panggilan tidak memiliki hak istimewa yang memadai.
ERROR_INVALID_HANDLE	Nilai hInterface tidak valid.
ERROR_INVALID_PARAMETER	Parameter lplpbBuffer adalah NULL.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
ERROR_NOT_SUPPORTED	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

Lihat juga

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceSetInfo

Bagikan melalui