The MprConfigTransportEnum function enumerates the transports configured on the router.
DWORD MprConfigTransportEnum( HANDLE hMprConfig, // handle to the router configuration DWORD dwLevel, // level of information requested LPBYTE *lplpBuffer, // array of MPR_TRANSPORT_0 structures DWORD dwPrefMaxLen, // maximum length of data to return LPDWORD lpdwEntriesRead, // number of entries enumerated LPDWORD lpdwTotalEntries, // number of entries that could've // been enumerated LPDWORD lpdwResumeHandle // handle for continuing the enumeration );
On output, the pointer variable points to an array of MPR_TRANSPORT_0 structures. Free this memory buffer by calling MprConfigBufferFree.
On input, the handle should be zero on the first call and left unchanged on subsequent calls.
On output, this variable contains a resume handle used to continue the enumeration. If the handle is NULL, the enumeration is complete.
If an error occurs in the enumeration, this handle is invalid.
This parameter is optional. If the calling application specifies NULL for this parameter, the function will not return a resume handle.
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
Value | Meaning |
---|---|
ERROR_INVALID_PARAMETER | At least one of the following is true:
|
ERROR_NOT_ENOUGH_MEMORY | Insufficient resources to complete the operation. |
ERROR_NO_MORE_ITEMS | No more entries available from the current resume position. |
Other | Use FormatMessage to retrieve the system error message that corresponds to the error code returned. |
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Configuration Functions, FormatMessage, MprConfigBufferFree, MprConfigServerConnect