|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| Dynamic load from RASMAN.DLL
| Header File
| rasshost.h
| Unicode
| No
| Platform Notes
| None
|
|
|
RasSecurityDialogSend
[New - Windows NT]
The RasSecurityDialogSend function sends a message to be displayed in a terminal window on a remote
computer. A third-party RAS security DLL sends this message as part of its
authentication of a remote user.
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 RasSecurityDialogSend entry point.
DWORD RasSecurityDialogSend(
HPORT hPort,
| // RAS handle to the port
| PBYTE pBuffer,
| // pointer to buffer containing data to send
| WORD BufferLength
| // size, in bytes, of the data being sent
| );
|
|
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 the send buffer that was passed to the security DLL in the call to RasSecurityDialogBegin. Before calling RasSecurityDialogSend, copy into this buffer the message to send to the remote user. The SendBufSize parameter of the RasSecurityDialogBegin function indicates the maximum number of bytes you can copy to this buffer.
BufferLength
Specifies the number of bytes to send in the pBuffer buffer.
Return Values
If the function is successful, the return value is PENDING (defined in
RASERROR.H). This indicates that the send operation is in progress.
If an error occurs, 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 RasSecurityDialogSend function is asynchronous. After calling it to send a message to the remote
user, call the RasSecurityDialogReceive function, and then wait for a response. The security DLL can make any number
of RasSecurityDialogSend calls, with each call followed by a RasSecurityDialogReceive call.
When a security DLL is authenticating a remote user, the connection operation
on the remote computer enters a RASCS_Interactive paused state. The message
sent by RasSecurityDialogSend is displayed as output in a terminal window on the remote computer. The
response received by RasSecurityDialogReceive is the input that the remote user types in the terminal window. The
RASCS_Interactive value is defined in the RASCONNSTATE enumeration.
See Also
GetProcAddress, LoadLibrary, RASCONNSTATE, RasSecurityDialogBegin, RasSecurityDialogReceive
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
