RasSecurityDialogGetInfo

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

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

DWORD RasSecurityDialogGetInfo(
  HPORT hPort,  // RAS handle to port
  RAS_SECURITY_INFO *pBuffer
                // pointer to structure that gets port information
);
 

Parameters

hPort

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

pBuffer

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

Return Values

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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in rasshost.h.
  Import Library: Included as a resource in rasman.dll.

See Also

Remote Access Service Overview, RAS Server Administration Functions, GetProcAddress, LoadLibrary, RAS_SECURITY_INFO, RasSecurityDialogReceive