Share via

RasEnumConnections

  • Article

This function lists all active RAS connections. It returns each connections handle and phone book entry name.

DWORD RasEnumConnections(
LPRASCONN lprasconn, 
LPDWORD lpcb, 
LPDWORD lpcConnections );

Parameters

  • lprasconn
    Long pointer to a buffer that receives an array of RASCONN structures, one for each RAS connection. Before calling the function, an application must set the dwSize member of the first RASCONN structure in the buffer to sizeof(RASCONN) in order to identify the version of the structure being passed.
  • lpcb
    Long pointer to a variable that that contains the size, in bytes, of the buffer specified by lprasconn. On return, the function sets this variable to the number of bytes required to enumerate the RAS connections.
  • lpcConnections
    Long pointer to a variable that the function sets to the number of RASCONN structures written to the buffer specified by lprasconn.

Return Values

Zero indicates success. A nonzero error value listed in the RAS header file, ERROR_BUFFER_TOO_SMALL, or ERROR_NOT_ENOUGH_MEMORY indicates failure.

Include Raserror.h for definitions of the RAS error codes.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Ras.h, Afdfunc.h   Ppp.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

RASCONN, RasEnumEntries, RasGetConnectStatus

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.