MprConfigInterfaceGetHandle-Funktion (mprapi.h)

Artikel
02/29/2024

Die MprConfigInterfaceGetHandle-Funktion ruft ein Handle für die Konfiguration der angegebenen Schnittstelle in der angegebenen Routerkonfiguration ab.

Syntax

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

Parameter

[in] hMprConfig

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

[in] lpwsInterfaceName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der Schnittstelle angibt, für die das Konfigurationshandle angefordert wird. Verwenden Sie die Schnittstellen-GUID als Namen einer LAN-Schnittstelle.

[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	Der hMprConfig-Parameter ist NULL, oder der lpwsInterfaceName-Parameter ist NULL, oder beide Parameter sind NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_NO_SUCH_INTERFACE	Die angegebene Schnittstelle wurde in der Routerkonfiguration nicht gefunden.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

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

MprConfigServerConnect

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung

Freigeben über