Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die MprAdminPortGetInfo-Funktion ruft Informationen für einen bestimmten Port ab.
Syntax
DWORD MprAdminPortGetInfo(
[in] RAS_SERVER_HANDLE hRasServer,
[in] DWORD dwLevel,
[in] HANDLE hPort,
[out] LPBYTE *lplpbBuffer
);
Parameter
[in] hRasServer
Behandeln Sie den RAS-Servercomputer, auf dem Portinformationen gesammelt werden sollen. 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. Zulässige Werte für dwLevel sind 0 und 1, wie in der folgenden Tabelle aufgeführt.
| Wert | Strukturformat |
|---|---|
| 0 | RAS_PORT_0 |
| 1 | RAS_PORT_1 |
[in] hPort
Behandeln Sie den Port, für den Informationen gesammelt werden sollen. Rufen Sie dieses Handle ab, indem Sie MprAdminPortEnum aufrufen.
[out] lplpbBuffer
Bei erfolgreicher Fertigstellung ein Zeiger auf eine Struktur, die den Port beschreibt. Diese Strukturen sind vom Typ RAS_PORT_0 oder RAS_PORT_1 abhängig vom Wert des dwLevel-Parameters . 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 |
|---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Der DDM (Demand Dial Manager) wird nicht ausgeführt, möglicherweise weil der Dynamische Schnittstellen-Manager (DIM) so konfiguriert ist, dass er nur in einem LAN ausgeführt wird. |
|
Mindestens einer der folgenden Parameter ist NULL oder verweist nicht auf gültigen Arbeitsspeicher: lplpBuffer, lpdwEntriesRead oder lpdwTotalEntries. |
|
Der hPort-Parameter ist ungültig. |
|
Der dwLevel-Parameter ist nicht 0. |
|
Ein Fehler von MprError.h, RasError.h oder WinError.h. |
Hinweise
Diese Funktion ist unter Windows NT 4.0 verfügbar, wenn die RRAS redistributable installiert ist. Die Version von Mprapi.dll, die im Lieferumfang der RRAS-Redistributable enthalten ist, exportiert die Funktion jedoch als RasAdminPortGetInfo und nicht als MprAdminPortGetInfo. Verwenden Sie daher bei Verwendung der RRAS redistributable LoadLibrary und GetProcAddress , um auf diese Funktion zuzugreifen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mprapi.h |
| Bibliothek | Mprapi.lib |
| DLL | Mprapi.dll |