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 obtains information about a remote access projection operation for a specified remote access component protocol.

Syntax 

DWORD RasGetProjectionInfo(
  HRASCONN
 hrasconn, 
  RASPROJECTION
 rasprojection, 
  LPVOID
 lpprojection, 
  LPDWORD
 lpcb 
);

Remarks

hrasconn

[in] Handle to the remote access connection of interest. An application obtains a RAS connection handle from the RasDialor RasEnumConnectionsfunction.

rasprojection

[in] A RASPROJECTIONenumerated type value that specifies the protocol of interest.

lpprojection

[out] Long pointer to a buffer that will receive the information specified by the rasprojectionparameter. The information will be in a structure appropriate to the rasprojectionvalue.

Rasprojection value Data structure Definition

RASP_PppIp

RASPPPIP

Specifies the IP control protocol. IPCP is a PPP network control protocol used to negotiate the parameters necessary to ship IP packets on a WAN link.
lpcb

[in, out] Long pointer to a variable that, on entry, specifies the size in bytes of the buffer pointed to by lpprojection. ON exit, this variable contains the size of buffer needed to contain the specified projection information.

Return Value

Zero indicates success. A nonzero error value indicates failure. The function may return a nonzero RAS error code, or one of the following error codes.

Value Description

ERROR_BUFFER_TOO_SMALL

The buffer pointed to by lpprojectionis not large enough to contain the requested information.

ERROR_INVALID_HANDLE

The hrasconnparameter is not a valid handle.

ERROR_INVALID_PARAMETER

One of the parameters is invalid.

ERROR_PROTOCOL_NOT_CONFIGURED

The control protocol for which information was requested neither succeeded nor failed, because the connection's phone-book entry did not require that an attempt to negotiate the protocol be made. This is a RAS error code.

Remarks

The remote access projection process negotiates network protocol-specific information between a remote access server and a remote client. A remote access server uses this network protocol-specific information to represent a remote client on the network.

Requirements

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

See Also