RasGetConnectStatusA-Funktion (ras.h)
Die RasGetConnectStatus- Funktion ruft Informationen zum aktuellen Status der angegebenen Remotezugriffsverbindung 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 Remotezugriffsverbindung an, für die der Status abgerufen werden soll. Dieser Handle muss von RasDial oder RasEnumConnectionsabgerufen worden sein.
[in, out] unnamedParam2
Zeiger auf die RASCONNSTATUS- Struktur, die bei der Ausgabe die Statusinformationen 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 Remotezugriffsfehlercodes oder Winerror.h.
| Wert | Bedeutung |
|---|---|
|
Die Funktion konnte nicht genügend Arbeitsspeicher zuordnen, um den Vorgang abzuschließen. |
Bemerkungen
Der Rückgabewert für RasGetConnectStatus- ist nicht unbedingt gleich dem Wert des dwError Member der RASCONNSTATUS Struktur, die von RasGetConnectStatuszurü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 die Einrichtung der Verbindung verhindert haben.
Anmerkung
Der ras.h-Header definiert RasGetConnectStatus 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
übersicht über Ras(Remote Access Service)