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 MprAdminInterfaceGetInfo-Funktion ruft Informationen für eine angegebene Schnittstelle auf einem angegebenen Server ab.
Syntax
DWORD MprAdminInterfaceGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[in] LPBYTE *lplpbBuffer
);
Parameter
[in] hMprServer
Verarbeiten Sie den router, um abzufragen. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminServerConnect abgerufen.
[in] hInterface
Behandeln Sie die Schnittstelle, die durch einen vorherigen Aufruf von MprAdminInterfaceCreate abgerufen wurde.
[in] dwLevel
Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpbBuffer-Parameter strukturiert sind. Zulässige Werte für dwLevel sind 0, 1, 2 und 3, wie in der folgenden Tabelle aufgeführt.
| Wert | Strukturformat |
|---|---|
| 0 | MPR_INTERFACE_0 |
| 1 | MPR_INTERFACE_1 |
| 2 | MPR_INTERFACE_2 |
| 3 | Windows Server 2008 oder höher: MPR_INTERFACE_3 |
Die Werte 1, 2 und 3 gelten nur für Schnittstellen vom Typ ROUTER_CONNECTION_STATE.
[in] lplpbBuffer
Ein Zeiger auf eine MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 oder MPR_INTERFACE_3 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 |
|---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
DwLevel ist 2, aber diese Ebene wird für die Schnittstelle nicht unterstützt. Beispielsweise ist der In der MPR_INTERFACE_X-Struktur definierte Schnittstellentyp nicht IF_TYPE_FULL_ROUTER. |
|
Der hInterface-Wert ist ungültig. |
|
Der lplpbBuffer-Parameter ist NULL. |
|
Unzureichende Ressourcen, um den Vorgang abzuschließen. |
|
Der dwLevel-Wert ist ungültig. |
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 |