The MprConfigInterfaceTransportEnum function enumerates the transports configured on the specified interface.
DWORD MprConfigInterfaceTransportEnum( HANDLE hMprConfig, // handle to the router configuration HANDLE hRouterInterface, // handle to the interface configuration DWORD dwLevel, // level of information requested LPBYTE *lplpBuffer, // array of MPR_IFTRANSPORT_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, points to an array of MPR_IFTRANSPORT_0 structures. This memory should be freed 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 | 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, MPR_IFTRANSPORT_0, MprConfigBufferFree, MprConfigInterfaceCreate, MprConfigInterfaceEnum, MprConfigInterfaceGetHandle