MprConfigInterfaceCreate-Funktion (mprapi.h)
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 |
|---|---|
|
Mindestens eine der folgenden Optionen muss zutreffen:
|
|
Unzureichende Ressourcen, um den Vorgang abzuschließen. |
|
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 |