RasSecurityDialogGetInfo function (rasshost.h)
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.
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 |