MprConfigInterfaceCreate-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigInterfaceCreate-Funktion erstellt eine Routerschnittstelle in der angegebenen Routerkonfiguration.

Syntax

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Parameter

[in] hMprConfig

Verarbeiten Sie die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lpbBuffer-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] phRouterInterface

Zeiger auf eine Handle-Variable. Diese Variable empfängt ein Handle für die Schnittstellenkonfiguration.

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_INVALID_PARAMETER	Mindestens eine der folgenden Optionen muss zutreffen: hMprConfig ist NULL. dwLevel ist nicht 0, 1, 2 oder 3. lpbBuffer ist NULL phRouterInterface ist NULL
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen, um den Vorgang abzuschließen.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

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