MprAdminDeviceEnum-Funktion (mprapi.h)

Die Funktion MprAdminDeviceEnum wird aufgerufen, um RAS-fähige Geräte aufzulisten, die auf dem Computer installiert sind und deren Namen und Typ zurückgeben können.

Syntax

DWORD MprAdminDeviceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [out] LPDWORD           lpdwTotalEntries
);

Parameter

[in] hMprServer

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

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpbBuffer-Parameter zurückgegeben werden. Muss Null sein.

[out] lplpbBuffer

Nach erfolgreicher Fertigstellung wird ein Array von MPR_DEVICE_0 Strukturen, das die RAS-fähigen Geräteinformationen enthält. Geben Sie diesen Arbeitsspeicher frei, indem Sie MprAdminBufferFree aufrufen.

[out] lpdwTotalEntries

Die Anzahl der Einträge vom Typ MPR_DEVICE_0 in lplpbBuffer.

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_NOT_SUPPORTED	Der dwlevel-Parameter ist nicht gleich Null.
ERROR_INVALID_PARAMETER	Der Parameter lplpbBuffer oder lpdwTotalEntries ist NULL.

Anforderungen

Anforderung	Wert
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

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung