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 |
|---|---|
|
Der dwlevel-Parameter ist nicht gleich Null. |
|
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 |