RasSecurityDialogSend 函式 (rasshost.h)

發行項
03/01/2024

RasSecurityDialogSend 函式會傳送要顯示在遠端電腦上的終端機視窗中的訊息。第三方 RAS 安全性 DLL 會在遠端使用者的驗證過程中傳送此訊息。

若要呼叫此函式，請先呼叫 LoadLibrary 函式以載入 Rasman.dll。然後呼叫 GetProcAddress 函式，以取得 DLL 的 RasSecurityDialogSend 進入點。

注意Windows Server 2008、Windows Server 2003、Windows 2000 Server 和 Windows NT Server 4.0 目前僅提供序列裝置的 RAS 安全性主機支援。不支援其他類型的連線，例如整合式服務數位網路 (ISDN) 或虛擬專用網 (VPN) 連線。

語法

DWORD RasSecurityDialogSend(
  [in] HPORT hPort,
  [in] PBYTE pBuffer,
  [in] WORD  BufferLength
);

參數

[in] hPort

指定 RAS 伺服器針對此驗證交易傳遞至 RasSecurityDialogBegin 呼叫中安全性 DLL 的埠句柄。

[in] pBuffer

呼叫 RasSecurityDialogBegin 時傳遞至安全性 DLL 之傳送緩衝區的指標。呼叫 RasSecurityDialogSend 之前，請將訊息複製到此緩衝區，以傳送給遠端使用者。 RasSecurityDialogBegin 函式的 SendBufSize 參數表示緩衝區可儲存的最大位元元數目。

[in] BufferLength

指定要在 pBuffer 緩衝區中傳送的位元組數目。

傳回值

如果函式成功，傳回值為PENDING (定義於 Raserror.h) 。這表示傳送作業正在進行中。

如果發生錯誤，傳回值就是 Raserror.h 或 Winerror.h 中定義的其中一個錯誤碼。 GetLastError 不提供擴充的錯誤資訊。

備註

RasSecurityDialogSend 函式是異步的。呼叫它以將訊息傳送給遠端用戶之後，請呼叫 RasSecurityDialogReceive 函式，然後等候回應。安全性 DLL 可以進行任意數目的 RasSecurityDialogSend 呼叫，每個呼叫後面接著 RasSecurityDialogReceive 呼叫。

當安全性 DLL 正在驗證遠端使用者時，遠端電腦上的連線作業會進入RASCS_Interactive暫停狀態。 RasSecurityDialogSend 所傳送的訊息會顯示為遠端電腦上的終端機視窗中的輸出。 RasSecurityDialogReceive 收到的回應是遠端使用者在終端機視窗中輸入的輸入。 RASCS_Interactive值定義在 RASCONNSTATE 列舉中。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	rasshost.h
Dll	Rasman.dll