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 Funktion MprAdminInterfaceCreate erstellt eine Schnittstelle auf einem angegebenen Server.
Syntax
DWORD MprAdminInterfaceCreate(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer,
[out] HANDLE *phInterface
);
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 lpBuffer-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 |
[in] lpbBuffer
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.
[out] phInterface
Zeiger auf eine HANDLE-Variable . Die Variable empfängt ein Handle, das in allen nachfolgenden Aufrufen zum Verwalten dieser Schnittstelle verwendet werden soll.
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 Routerschnittstellentyp wird nicht unterstützt, da der dynamische Schnittstellen-Manager nur für die Ausführung in einem LAN konfiguriert ist. |
|
Eine Schnittstelle mit demselben Namen ist bereits vorhanden. |
|
Unzureichende Ressourcen, um den Vorgang abzuschließen. |
|
Der dwLevel-Wert ist ungültig. |
Hinweise
Die MprAdminInterfaceCreate-Funktion unterstützt die MPR_INTERFACE_2-Struktur . MprConfigInterfaceCreate tut dies jedoch nicht. Um eine Schnittstelle mit Bedarf zu erstellen, die nach einem Neustart dauerhaft ist, rufen Sie MprAdminInterfaceCreate mit MPR_INTERFACE_2 auf, und rufen Sie dann MprConfigInterfaceCreate mit MPR_INTERFACE_0 oder MPR_INTERFACE_1 auf.
Anforderungen
| 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 |