MprAdminInterfaceDeviceGetInfo-Funktion (mprapi.h)
MprAdminInterfaceDeviceGetInfo ruft Informationen zu einem Gerät ab, das in einer Router-Schnittstelle für Die Bedarfswahl verwendet wird.
DWORD MprAdminInterfaceDeviceGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwIndex,
[in] DWORD dwLevel,
[out] LPBYTE *lplpBuffer
);
[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.
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 |
---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Der hInterface-Wert ist ungültig. |
|
Der lplpbBuffer-Parameter ist NULL. |
|
Unzureichende Ressourcen zum Abschließen des Vorgangs. |
|
Der dwLevel-Wert ist ungültig. |
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 |