MprConfigInterfaceTransportEnum-Funktion (mprapi.h)

Artikel
08/24/2023

Die MprConfigInterfaceTransportEnum-Funktion listet die Transporte auf, die auf der angegebenen Schnittstelle konfiguriert sind.

Syntax

DWORD MprConfigInterfaceTransportEnum(
  [in]                HANDLE  hMprConfig,
  [in]                HANDLE  hRouterInterface,
  [in]                DWORD   dwLevel,
  [in, out]           LPBYTE  *lplpBuffer,
  [in]                DWORD   dwPrefMaxLen,
  [out]               LPDWORD lpdwEntriesRead,
  [out]               LPDWORD lpdwTotalEntries,
  [in, out, optional] LPDWORD lpdwResumeHandle
);

Parameter

[in] hMprConfig

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

[in] hRouterInterface

Handle mit der Schnittstellenkonfiguration, von der aus die Transporte aufgezählt werden sollen. Rufen Sie dieses Handle ab, indem Sie MprConfigInterfaceCreate oder MprConfigInterfaceEnum aufrufen.

[in] dwLevel

Ein DWORD-Wert , der das Format beschreibt, in dem die Informationen im lplpBuffer-Parameter zurückgegeben werden. Muss Null sein.

[in, out] lplpBuffer

Bei der Eingabe ein Nicht-NULL-Zeiger .

Bei erfolgreicher Fertigstellung ein Zeiger auf ein Array von MPR_IFTRANSPORT_0 Strukturen. Geben Sie diesen Speicherpuffer frei, indem Sie MprConfigBufferFree aufrufen.

[in] dwPrefMaxLen

Gibt die bevorzugte maximale Länge der zurückgegebenen Daten (in 8-Bit-Bytes) an. Wenn dieser Parameter -1 ist, ist der zurückgegebene Puffer groß genug, um alle verfügbaren Informationen zu enthalten.

[out] lpdwEntriesRead

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Gesamtzahl der Einträge, die von der aktuellen Position des Lebenslaufs aufgezählt wurden.

[out] lpdwTotalEntries

Zeiger auf eine DWORD-Variable . Diese Variable empfängt die Gesamtzahl der Einträge, die aus der aktuellen Position des Lebenslaufs hätten aufgezählt werden können.

[in, out, optional] lpdwResumeHandle

Zeiger auf eine DWORD-Variable .

Bei der Eingabe sollte das Handle beim ersten Aufruf null sein und bei nachfolgenden Aufrufen unverändert bleiben.

Bei der Ausgabe enthält diese Variable ein Resume-Handle, das zum Fortsetzen der Enumeration verwendet wird. Wenn das Handle NULL ist, ist die Enumeration abgeschlossen.

Wenn in der Enumeration ein Fehler auftritt, ist dieses Handle ungültig.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, gibt die Funktion kein Resume-Handle zurück.

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	Es trifft eine der folgenden Bedingungen zu: hMprConfig ist NULL. HRouterInterface ist NULL. dwLevel ist nicht null. lplpBuffer ist NULL. dwPrefMaxLen ist kleiner als die Größe einer einzelnen MPR_IFTRANSPORT_0-Struktur . lpdwEntriesRead ist NULL. lpdwTotalEntries ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_NO_MORE_ITEMS	Von der aktuellen Position des Lebenslaufs sind keine einträge mehr verfügbar.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

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