Freigeben über

MprConfigInterfaceSetInfo-Funktion (mprapi.h)

Die MprConfigInterfaceSetInfo-Funktion legt die Konfiguration für die angegebene Schnittstelle fest.

Syntax

DWORD MprConfigInterfaceSetInfo(
  [in] HANDLE hMprConfig,
  [in] HANDLE hRouterInterface,
  [in] DWORD  dwLevel,
  [in] LPBYTE lpbBuffer
);

Parameter

[in] hMprConfig

Handle für die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] hRouterInterface

Handle für die Schnittstellenkonfiguration, die aktualisiert wird. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceCreate, MprConfigInterfaceGetHandle oder MprConfigInterfaceEnum 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. Die Informationen in dieser Struktur werden verwendet, um die Schnittstellenkonfiguration zu aktualisieren.

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.
  • hRouterInterface ist NULL.
  • dwLevel ist nicht 0, 1, 2 oder 3.
  • lpBuffer ist NULL.
Gibt diesen Fehlercode auch zurück, wenn die Schnittstelle vom Typ ROUTER_IF_TYPE_DEDICATED oder ROUTER_IF_TYPE_INTERNAL ist und die Schnittstelle aktiviert ist.
ERROR_NO_SUCH_INTERFACE
 Die Schnittstelle, die hRouterInterface entspricht, ist in der Routerkonfiguration nicht vorhanden.
Andere
 Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Die MprAdminInterfaceSetInfo-Funktion unterstützt die MPR_INTERFACE_2-Struktur . MprConfigInterfaceSetInfo ist dies jedoch nicht. Rufen Sie mprAdminInterfaceSetInfo mit MPR_INTERFACE_2 auf, und rufen Sie dann MprConfigInterfaceSetInfo mit MPR_INTERFACE_0 oder MPR_INTERFACE_1 auf, um dauerhafte Änderungen an einer Bedarfswahlschnittstelle vorzunehmen.

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

Weitere Informationen

FormatMessage

MprConfigInterfaceErstellen

MprConfigInterfaceEnum

MprConfigInterfaceGetHandle

MprConfigServerConnect

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung

  • Last updated on