MprAdminInterfaceSetInfo-Funktion (mprapi.h)

Artikel
02/29/2024

Die Funktion MprAdminInterfaceSetInfo legt Informationen für eine angegebene Schnittstelle auf einem angegebenen Server fest.

Syntax

DWORD MprAdminInterfaceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

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 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.

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_INVALID_HANDLE	Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER	Der lplpbBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_NOT_SUPPORTED	Der dwLevel-Wert ist ungültig.

Hinweise

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

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