PFNRASSETCOMMSETTINGS callback function (ras.h)

Call RasSetCommSettings from a custom-scripting DLL to change the settings on the port for the connection.


PFNRASSETCOMMSETTINGS Pfnrassetcommsettings;

DWORD Pfnrassetcommsettings(
  [in] HANDLE hPort,
  [in] tagRASCOMMSETTINGS *pRasCommSettings,
  [in] PVOID pvReserved


[in] hPort

Handle to the port on which to apply the settings. This handle is passed to the custom-scripting DLL in the RasCustomScriptExecute function.

[in] pRasCommSettings

Pointer to a RASCOMMSETTINGS structure that specifies the settings to be applied to the port.

[in] pvReserved

Reserved for future use. This parameter must be NULL.

Return value

This callback function does not return a value.


RAS passes the custom-scripting DLL a pointer to the RasSetCommSettings function when RAS calls RasCustomScriptExecute. The pointer is stored in the RASCUSTOMSCRIPTEXTENSIONS structure that is passed as the last parameter of RasCustomScriptExecute.


Minimum supported client Windows XP, Windows 2000 Professional with SP2 [desktop apps only]
Minimum supported server Windows Server 2003, Windows 2000 Server with SP2 [desktop apps only]
Target Platform Windows
Header ras.h

See also

RAS Custom-Scripting