Share via

RasCustomScriptExecute

  • Article

This function must be exported by the custom-scripting dynamic-link library (DLL), which is implemented by the developer. RAS calls this function when establishing a connection, allowing the DLL to communicate with the server and thus customize the connection process.

DWORD RasCustomScriptExecute(
  HANDLE hPort, 
  LPCWSTR lpszPhonebook, 
  LPCWSTR lpszEntryName, 
  PFNRASGETBUFFER pfnRasGetBuffer, 
  PFNRASFREEBUFFER pfnRasFreeBuffer, 
  PFNRASSENDBUFFER pfnRasSendBuffer, 
  PFNRASRECEIVEBUFFER pfnRasReceiveBuffer, 
  PFNRASRETRIEVEBUFFER pfnRasRetrieveBuffer, 
  HWND hWnd, 
  RASDIALPARAMS* pRasDialParams, 
  RASCUSTOMSCRIPTEXTENSIONS* pRasCustomScriptExtensions 
);

Parameters

  • hPort
    [in] Handle to the port on which the connection is established. Use this handle when sending or receiving data on the port.
  • lpszPhonebook
    [in] Not used. Value always equals NULL.
  • lpszEntryName
    [in] Pointer to a Unicode string that contains the name of the entry that was dialed to establish the connection.
  • pfnRasGetBuffer
    [in] Pointer to a function of type PFNRASGETBUFFER. The custom-scripting DLL should use this function to allocate memory to send data to the server.
  • pfnRasFreeBuffer
    [in] Pointer to a function of type PFNRASFREEBUFFER. The custom-scripting DLL should use this function to free memory allocated by the pfnRasGetBuffer parameter.
  • pfnRasSendBuffer
    [in] Pointer to a function of type PFNRASSENDBUFFER. The custom-scripting DLL uses this function to communicate with the server over the specified port.
  • pfnRasReceiveBuffer
    [in] Pointer to a function of type PFNRASRECEIVEBUFFER. The custom-scripting DLL uses this function to communicate with the server over the specified port.
  • pfnRasRetrieveBuffer
    [in] Pointer to a function of type PFNRASRETRIEVEBUFFER. The custom-scripting DLL uses this function to communicate with the server over the specified port.
  • hWnd
    [in] Handle to a window that the custom-scripting DLL can use to present a user interface to the user.
  • pRasDialParams
    [in] Pointer to a Unicode RASDIALPARAMS structure. This structure contains the authentication credentials for the user. The custom-scripting DLL can modify the szUserName, szPassword, and szDomain members of this structure. The Point-to-Point Protocol (PPP) will use whatever is stored in these members when RasCustomScriptExecute returns.
  • pRasCustomScriptExtensions
    [in] Not used. Value always equals NULL.

Return Values

If the function succeeds, it should return ERROR_SUCCESS.

If the function fails, the return value should be an appropriate error code from Winerror.h or Raserror.h.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header:RasCustomScriptExecute is exported from the custom-scripting DLL, and therefore is not defined in a header file.
Link Library: Developer-implemented.

See Also

RAS Custom Scripting | RasFreeBuffer | RasGetBuffer | RasReceiveBuffer | RasRetrieveBuffer | RasSendBuffer

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.