Freigeben über


MprAdminInterfaceCreate-Funktion (mprapi.h)

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
ERROR_ACCESS_DENIED
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_DDM_NOT_RUNNING
Der Routerschnittstellentyp wird nicht unterstützt, da der dynamische Schnittstellen-Manager nur für die Ausführung in einem LAN konfiguriert ist.
ERROR_INTERFACE_ALREADY_EXISTS
Eine Schnittstelle mit demselben Namen ist bereits vorhanden.
ERROR_NOT_ENOUGH_MEMORY
Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_NOT_SUPPORTED
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

Weitere Informationen

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MPR_INTERFACE_3

MprAdminInterfaceDelete

MprAdminServerConnect

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung