MprAdminInterfaceDeviceGetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

MprAdminInterfaceDeviceGetInfo ruft Informationen zu einem Gerät ab, das in einer Router-Schnittstelle für Die Bedarfswahl verwendet wird.

Syntax

DWORD MprAdminInterfaceDeviceGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwIndex,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpBuffer
);

Parameter

[in] hMprServer

Handle an Router, auf dem dieser Aufruf ausgeführt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle für die -Schnittstelle. Rufen Sie dieses Handle aus einem vorherigen Aufruf von MprAdminInterfaceCreate oder durch Aufrufen von MprAdminInterfaceEnum ab.

[in] dwIndex

Gibt den 1-basierten Index des Geräts an. Eine multiverknüpfte Bedarfswahlschnittstelle verwendet mehrere Geräte.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpBuffer-Parameter zurückgegeben werden. Zulässige Werte für dwLevel sind 0 oder 1, wie in der folgenden Tabelle aufgeführt.

Wert	Strukturformat
0	MPR_DEVICE_0
1	MPR_DEVICE_1

[out] lplpBuffer

Bei erfolgreicher Fertigstellung ein Zeiger auf eine MPR_DEVICE_0- oder MPR_DEVICE_1-Struktur . Der dwLevel-Parameter gibt den Typ der Struktur an. Geben Sie diesen Arbeitsspeicher frei, indem Sie MprAdminBufferFree aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_HANDLE	Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER	Der lplpbBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_NOT_SUPPORTED	Der dwLevel-Wert ist ungültig.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll

Weitere Informationen

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceErstellen

MprAdminInterfaceDeviceSetInfo

Freigeben über