RasConnectionNotificationA-Funktion (ras.h)

Artikel
03/13/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, das von der RasDial - oder RasEnumConnections-Funktion zurückgegeben wird. Wenn dieser Parameter INVALID_HANDLE_VALUE ist, 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 durch den hEvent-Parameter angegebene Ereignisobjekt signalisiert. Dieser Parameter ist eine Kombination der folgenden Werte.

Wert	Bedeutung
RASCN_Connection	Wenn hrasconnINVALID_HANDLE_VALUE ist, wird hEvent signalisiert, wenn eine RAS-Verbindung erstellt wird.
RASCN_Disconnection	hEvent wird signalisiert, wenn die hrasconn-Verbindung beendet wird. Wenn hrasconn eine Multilinkverbindung ist, wird das Ereignis signalisiert, wenn alle Untergeordneten getrennt werden. Wenn hrasconnINVALID_HANDLE_VALUE ist, 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 Unterversuch verbunden ist.
RASCN_BandwidthRemoved	Windows NT: Wenn hrasconn ein Handle für eine kombinierte Multilinkverbindung ist, wird hEvent signalisiert, wenn ein Unterversuch 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 ungleich Null aus Routing- und RAS-Fehlercodes oder Winerror.h.

Hinweise

Um zu bestimmen, wann das Ereignisobjekt signalisiert wird, verwenden Sie eine der Wartefunktionen.

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

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll

Weitere Informationen

CreateEvent

RasEnumConnections

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts

Share via