RasGetConnectStatusA-Funktion (ras.h)

Artikel
08/25/2023

Die RasGetConnectStatus-Funktion ruft Informationen zum aktuellen status der angegebenen RAS-Verbindung ab. Eine Anwendung kann diesen Aufruf verwenden, um zu bestimmen, wann ein asynchroner RasDial-Aufruf abgeschlossen ist.

Syntax

DWORD RasGetConnectStatusA(
  [in]      HRASCONN         unnamedParam1,
  [in, out] LPRASCONNSTATUSA unnamedParam2
);

Parameter

[in] unnamedParam1

Gibt die RAS-Verbindung an, für die die status abgerufen werden soll. Dieses Handle muss von RasDial oder RasEnumConnections abgerufen worden sein.

[in, out] unnamedParam2

Zeiger auf die RASCONNSTATUS-Struktur, die bei der Ausgabe die status Informationen empfängt.

Legen Sie bei der Eingabe das dwSize-Element der Struktur auf sizeof(RASCONNSTATUS) fest, um die Version der übergebenen Struktur zu identifizieren.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
ERROR_NOT_ENOUGH_MEMORY	Die Funktion konnte nicht genügend Arbeitsspeicher zuweisen, um den Vorgang abzuschließen.

Hinweise

Der Rückgabewert für RasGetConnectStatus entspricht nicht unbedingt dem Wert des dwError-Members der RASCONNSTATUS-Struktur , die von RasGetConnectStatus zurückgegeben wird. Der Rückgabewert von RasGetConnectStatus gibt Fehler an, die während des RasGetConnectStatus-Funktionsaufrufs auftreten, während der dwError-Member Fehler angibt, die das Herstellen der Verbindung verhindert haben.

Hinweis

Der ras.h-Header definiert RasGetConnectStatus als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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