Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

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

Parameters

lprasconn

Long pointer to a buffer that receives an array of RASCONNstructures, one for each RAS connection. Before calling the function, an application must set the dwSizemember of the first RASCONNstructure 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 RASCONNstructures written to the buffer specified by lprasconn.

Return Value

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

Header ras.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also