RasGetLinkStatistics
This function retrieves accumulated statistics for the specified link in a RAS multilink connection.
DWORD RasGetLinkStatistics(
HRASCONN hRasConn,
DWORD dwSubEntry,
RAS_STATS* lpStatistics
);
Parameters
- hRasConn
Handle to the connection. Use RasDial or RasEnumConnections to obtain this handle. - dwSubEntry
Specifies the subentry that corresponds to the link for which to retrieve statistics. - lpStatistics
Pointer to a RAS_STATS structure to receive the statistics. Set the dwSize member of this structure to sizeof(RAS_STATS) before calling RasGetLinkStatistics. This parameter cannot be NULL.
Return Values
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value is one of the following error codes.
Value | Description |
---|---|
E_INVALID_ARG | At least one of the following is true: the hRasConn parameter is zero, the dwSubEntry parameter is zero, the lpStatistics parameter is NULL, or the value specified by the dwSize member of the RAS_STATS structure specifies a version of the structure that is not supported by the operating system in use. |
ERROR_NOT_ENOUGH_MEMORY | The function could not allocate sufficient memory to complete the operation. |
Other | Use FormatMessage to retrieve the system error message that corresponds to the error code returned. |
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Ras.h.h.
Link Library: Coredll.lib.
See Also
RasDial | RasEnumConnections | RasGetConnectStatus | RasGetLinkStatistics
Last updated on Thursday, April 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.