PFNRASSETCOMMSETTINGS callback function (ras.h)

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

Syntax

PFNRASSETCOMMSETTINGS Pfnrassetcommsettings;

DWORD Pfnrassetcommsettings(
  [in] HANDLE hPort,
  [in] tagRASCOMMSETTINGS *pRasCommSettings,
  [in] PVOID pvReserved
)
{...}

Parameters

[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.

Remarks

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.

Requirements

   
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

RASCOMMSETTINGS

RasCustomScriptExecute