RasSecurityDialogSend-Funktion (rasshost.h)
Die RasSecurityDialogSend-Funktion sendet eine Nachricht, die in einem Terminalfenster auf einem Remotecomputer angezeigt wird. Eine RAS-Sicherheits-DLL eines Drittanbieters sendet diese Nachricht im Rahmen der Authentifizierung eines Remotebenutzers.
Um diese Funktion aufzurufen, rufen Sie zuerst die LoadLibrary-Funktion auf, um Rasman.dll zu laden. Rufen Sie dann die GetProcAddress-Funktion auf, um den Einstiegspunkt RasSecurityDialogSend der DLL abzurufen.
Syntax
DWORD RasSecurityDialogSend(
[in] HPORT hPort,
[in] PBYTE pBuffer,
[in] WORD BufferLength
);
Parameter
[in] hPort
Gibt das Porthandle an, das der RAS-Server im RasSecurityDialogBegin-Aufruf für diese Authentifizierungstransaktion an die Sicherheits-DLL übergeben hat.
[in] pBuffer
Zeiger auf den Sendepuffer, der im Aufruf von RasSecurityDialogBegin an die Sicherheits-DLL übergeben wurde. Kopieren Sie vor dem Aufrufen von RasSecurityDialogSend die Nachricht, die an den Remotebenutzer gesendet werden soll, in diesen Puffer. Der SendBufSize-Parameter der RasSecurityDialogBegin-Funktion gibt die maximale Anzahl von Bytes an, die der Puffer speichern kann.
[in] BufferLength
Gibt die Anzahl der Bytes an, die im pBuffer-Puffer gesendet werden sollen.
Rückgabewert
Wenn die Funktion erfolgreich ist, lautet der Rückgabewert PENDING (definiert in Raserror.h). Dies gibt an, dass der Sendevorgang ausgeführt wird.
Wenn ein Fehler auftritt, ist der Rückgabewert einer der Fehlercodes, die in Raserror.h oder Winerror.h definiert sind. GetLastError stellt keine erweiterten Fehlerinformationen bereit.
Hinweise
Die RasSecurityDialogSend-Funktion ist asynchron. Nachdem Sie sie aufgerufen haben, um eine Nachricht an den Remotebenutzer zu senden, rufen Sie die RasSecurityDialogReceive-Funktion auf, und warten Sie dann auf eine Antwort. Die Sicherheits-DLL kann eine beliebige Anzahl von RasSecurityDialogSend-Aufrufen ausführen, wobei jedem Aufruf ein RasSecurityDialogReceive-Aufruf folgt.
Wenn eine Sicherheits-DLL einen Remotebenutzer authentifiziert, wechselt der Verbindungsvorgang auf dem Remotecomputer in einen RASCS_Interactive angehaltenen Zustand. Die von RasSecurityDialogSend gesendete Nachricht wird als Ausgabe in einem Terminalfenster auf dem Remotecomputer angezeigt. Die von RasSecurityDialogReceive empfangene Antwort ist die Eingabe, die der Remotebenutzer im Terminalfenster eingibt. Der RASCS_Interactive Wert wird in der RASCONNSTATE-Enumeration definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rasshost.h |
| DLL | Rasman.dll |