MprConfigTransportEnum-Funktion (mprapi.h)
Die MprConfigTransportEnum-Funktion listet die auf dem Router konfigurierten Transporte auf.
DWORD MprConfigTransportEnum(
[in] HANDLE hMprConfig,
[in] DWORD dwLevel,
[in, out] LPBYTE *lplpBuffer,
[in] DWORD dwPrefMaxLen,
[out] LPDWORD lpdwEntriesRead,
[out] LPDWORD lpdwTotalEntries,
[in, out, optional] LPDWORD lpdwResumeHandle
);
[in] hMprConfig
Handle mit der Routerkonfiguration für die Transporte. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect 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_TRANSPORT_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.
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 zum Abschließen des Vorgangs. |
|
Von der aktuellen Position des Lebenslaufs sind keine einträge mehr verfügbar. |
|
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht. |
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 |