RasSecurityDialogGetInfo function (rasshost.h)

Article
10/13/2021

The RasSecurityDialogGetInfo function is called by a RAS security DLL to get information about a port from the RAS server.

To call this function, first call the LoadLibrary function to load Rasman.dll. Then call the GetProcAddress function to get the DLL's RasSecurityDialogGetInfo entry point.

Note Windows Server 2008, Windows Server 2003, Windows 2000 Server, and Windows NT Server 4.0 currently provide RAS security host support for serial devices only. Other types of connections, such as Integrated Services Digital Network (ISDN) or virtual private network (VPN) connections, are not supported.

Syntax

DWORD RasSecurityDialogGetInfo(
  [in] HPORT             hPort,
  [in] RAS_SECURITY_INFO *pBuffer
);

Parameters

[in] hPort

Specifies the port handle that the RAS server passed to the security DLL in the RasSecurityDialogBegin call for this authentication transaction.

[in] pBuffer

Pointer to the RAS_SECURITY_INFO structure that receives information about the specified RAS port.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the error codes defined in Raserror.h or Winerror.h. GetLastError does not provide extended error information.

Remarks

The RasSecurityDialogGetInfo function retrieves information about the port associated with a RAS security DLL authentication transaction.

The LastError member of the RAS_SECURITY_INFO structure indicates the state of the last RasSecurityDialogReceive call for the port. If the receive operation has been completed successfully, LastError is SUCCESS and the BytesReceived member indicates the number of bytes received. Otherwise, LastError is PENDING if the receive operation is still in progress, or a nonzero error code if the receive operation failed.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	rasshost.h
DLL	Rasman.dll