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 LoadLibrary1VGHBF8 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