MprAdminServerGetInfo

The MprAdminServerGetInfo function retrieves routing and RAS information from a specified server.

DWORD MprAdminServerGetInfo(
  MPR_SERVER_HANDLE hMprServer,  // handle to router
  DWORD dwLevel,                 // level of information requested
  LPBYTE *lplpbBuffer            // MPR_SERVER_0 structure
);

Parameters

hMprServer
[in] Handle to the Windows 2000 router to query. Obtain this handle by calling MprAdminMIBServerConnect.
dwLevel
[in] Specifies the level of the information returned in lplpbBuffer. Must be zero.
lplpbBuffer
[out] Pointer to a pointer variable. On successful return, this pointer variable points to an MPR_SERVER_0 structure. Free this memory by calling MprAdminBufferFree.

Return Values

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_INVALID_PARAMETER The lplpbBuffer parameter is NULL.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Mprapi.h.
  Library: Use Mprapi.lib.

See Also

Router Management Reference, Router Administration Functions, MprAdminBufferFree, MPR_SERVER_0, MprAdminServerConnect