RasSecurityDialogSend 関数 (rasshost.h)

[アーティクル]
08/25/2023

RasSecurityDialogSend 関数は、リモートコンピューターのターミナルウィンドウに表示されるメッセージを送信します。サードパーティの RAS セキュリティ DLL は、リモートユーザーの認証の一部としてこのメッセージを送信します。

この関数を呼び出すには、最初に LoadLibrary 関数を呼び出して、Rasman.dll を読み込みます。次に、GetProcAddress 関数を呼び出して、DLL の RasSecurityDialogSend エントリポイントを取得します。

メモWindows Server 2008、Windows Server 2003、Windows 2000 Server、Windows NT Server 4.0 では、現在、シリアルデバイスのみの RAS セキュリティホストサポートが提供されています。 Integrated Services Digital Network (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 で定義されているエラーコードの 1 つです。 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