MprConfigInterfaceEnum function (mprapi.h)
The MprConfigInterfaceEnum function enumerates the interfaces that are configured for the router.
DWORD MprConfigInterfaceEnum( [in] HANDLE hMprConfig, [in] DWORD dwLevel, [in, out] LPBYTE *lplpBuffer, [in] DWORD dwPrefMaxLen, [out] LPDWORD lpdwEntriesRead, [out] LPDWORD lpdwTotalEntries, [in, out, optional] LPDWORD lpdwResumeHandle );
Handle to the router configuration. Obtain this handle by calling MprConfigServerConnect.
A DWORD value that describes the format in which the information is returned in the lplpBuffer parameter. Must be zero.
[in, out] lplpBuffer
On input, a non-NULL pointer.
Specifies the preferred maximum length of returned data (in 8-bit bytes). If this parameter is -1, the buffer returned will be large enough to hold all available information.
Pointer to a DWORD variable. This variable receives the total number of entries that were enumerated from the current resume position.
Pointer to a DWORD variable. This variable receives the total number of entries that could have been enumerated from the current resume position.
[in, out, optional] lpdwResumeHandle
Pointer to a DWORD variable.
On input, the handle should be zero on the first call, and left unchanged on subsequent calls to continue the enumeration.
On output, contains a resume handle that can be 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 does 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.
One of the following is true:
||Insufficient resources to complete the operation.|
||No more entries available from the current resume position.|
||Use FormatMessage to retrieve the system error message that corresponds to the error code returned.|
|Minimum supported client||None supported|
|Minimum supported server||Windows 2000 Server [desktop apps only]|