[This is preliminary documentation and subject to change.]
The MprAdminInterfaceEnum function enumerates all the interfaces on a specified server.
DWORD MprAdminInterfaceEnum(
MPR_SERVER_HANDLE hMprServer, // handle to the router
DWORD dwLevel, // level of information provided
LPBYTE *lplpbBuffer, // array of information structures
DWORD dwPrefMaxLen, // maximum length of data to return
HANDLE lpdwEntriesRead, // number of interfaces enumerated
HANDLE lpdwTotalEntries, // number of interfaces that could
// have been enumerated
LPDWORD lpdwResumeHandle // handle for continuing
// the enumeration
);
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_ACCESS_DENIED | The calling application does not have sufficient privileges. |
| ERROR_MORE_DATA | More information is available; the enumeration can be continued. |
| ERROR_NOT_ENOUGH_MEMORY | Insufficient resources to complete the operation. |
| ERROR_NOT_SUPPORTED | The value of dwLevel is invalid. |
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Administration Functions, MPR_INTERFACE_1, MprAdminBufferFree, MprAdminServerConnect