RasConnectionNotificationA-Funktion (ras.h)

Artikel
11/20/2024

Die RasConnectionNotification--Funktion gibt ein Ereignisobjekt an, das das System auf den signalierten Zustand festlegt, wenn eine RAS-Verbindung erstellt oder beendet wird.

Syntax

DWORD RasConnectionNotificationA(
  [in] HRASCONN unnamedParam1,
  [in] HANDLE   unnamedParam2,
  [in] DWORD    unnamedParam3
);

Parameter

[in] unnamedParam1

Ein Handle für die RAS-Verbindung, die die Benachrichtigungen empfängt. Dies kann ein Handle sein, der von der RasDial- oder RasEnumConnections-Funktion zurückgegeben wird. Wenn dieser Parameter INVALID_HANDLE_VALUEist, werden Benachrichtigungen für alle RAS-Verbindungen auf dem lokalen Client empfangen.

[in] unnamedParam2

Gibt das Handle eines Ereignisobjekts an. Verwenden Sie die CreateEvent-Funktion, um ein Ereignisobjekt zu erstellen.

[in] unnamedParam3

Gibt das RAS-Ereignis an, das bewirkt, dass das System das vom hEvent Parameter angegebene Ereignisobjekt signalisiert. Dieser Parameter ist eine Kombination aus den folgenden Werten.

Wert	Bedeutung
RASCN_Connection	Wenn hrasconnINVALID_HANDLE_VALUEist, wird hEvent- signalisiert, wenn eine RAS-Verbindung erstellt wird.
RASCN_Disconnection	hEvent- wird signalisiert, wenn die Verbindung beendet wird. Wenn hrasconn eine Multilinkverbindung ist, wird das Ereignis signalisiert, wenn alle Untervorgänge getrennt werden. Wenn hrasconnINVALID_HANDLE_VALUEist, wird das Ereignis signalisiert, wenn eine RAS-Verbindung beendet wird.
RASCN_BandwidthAdded	Windows NT: Wenn hrasconn ein Handle für eine kombinierte Multilinkverbindung ist, wird hEvent- signalisiert, wenn ein Untervorgang verbunden ist.
RASCN_BandwidthRemoved	Windows NT: Wenn hrasconn ein Handle für eine kombinierte Multilinkverbindung ist, wird hEvent- signalisiert, wenn ein Untervorgang getrennt wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode ohne Null aus Routing- und Remotezugriffsfehlercodes oder Winerror.h.

Bemerkungen

Um zu bestimmen, wann das Ereignisobjekt signalisiert wird, verwenden Sie eine der Wait-Funktionen.

Wenn das Ereignis signalisiert wird, verwenden Sie andere RAS-Funktionen, z. B. RasEnumConnections, um weitere Informationen zu der RAS-Verbindung abzurufen, die erstellt oder beendet wurde.

Anmerkung

Der Ras.h-Header definiert RasConnectionNotification als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ras.h
Library	Rasapi32.lib
DLL-	Rasapi32.dll

Siehe auch

CreateEvent-

RasEnumConnections-

übersicht über Ras(Remote Access Service)

Remotezugriffsdienstfunktionen

Freigeben über