RasGetConnectStatusA-Funktion (ras.h)
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 |
|---|---|
|
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 |