RasGetProjectionInfoEx-Funktion (ras.h)

Die RasGetProjectionInfoEx-Funktion ruft Informationen zu Point-to-Point-Protokoll (PPP) oder Internet Key Exchange Version 2 (IKEv2)-Remotezugriffsprojektionsvorgängen für alle RAS-Verbindungen auf dem lokalen Client ab.

Syntax

DWORD RasGetProjectionInfoEx(
  [in]      HRASCONN             hrasconn,
  [in, out] PRAS_PROJECTION_INFO pRasProjection,
  [in, out] LPDWORD              lpdwSize
);

Parameter

[in] hrasconn

Ein Handle für die RAS-Verbindung, für die die Tunnelendpunkte geändert werden sollen. Dies kann ein Handle sein, das von der RasDial - oder RasEnumConnections-Funktion zurückgegeben wird.

[in, out] pRasProjection

Ein Zeiger auf eine RAS_PROJECTION_INFO-Struktur , die die Projektionsinformationen für die RAS-Verbindungen empfängt.

[in, out] lpdwSize

Ein Zeiger in der Eingabe, der die Größe des Puffers in Bytes angibt, auf den pRasProjection verweist. Bei der Ausgabe empfängt diese Variable die Größe des Puffers in Bytes, die zum Speichern der Anzahl von RAS_PROJECTION_INFO Strukturen benötigt wird, auf die von pRasProjection verwiesen wird.

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_BUFFER_TOO_SMALL	Der Puffer, auf den pRasProjection verweist, ist nicht groß genug, um die angeforderten Informationen zu enthalten.
ERROR_INVALID_HANDLE	Der hrasconn-Parameter ist kein gültiges Handle.
ERROR_INVALID_PARAMETER	Die Funktion wurde mit einem ungültigen Parameter aufgerufen.
ERROR_INVALID_SIZE	Das dwSize-Element der Struktur, auf die von pRasProjection verwiesen wird, gibt eine ungültige Größe an.
ERROR_PROTOCOL_NOT_CONFIGURED	Das Kontrollprotokoll, für das Informationen angefordert wurden, war weder erfolgreich noch fehlgeschlagen, da der Telefonbucheintrag der Verbindung keinen Versuch erforderte, das Protokoll auszuhandeln.

Hinweise

Die Remotezugriffsprojektion ist der Prozess, bei dem ein RAS-Server und ein Remoteclient netzwerkprotokollspezifische Informationen aushandeln. Ein RAS-Server verwendet diese netzwerkprotokollspezifischen Informationen, um einen Remoteclient im Netzwerk darzustellen.

Informationen zur Remotezugriffsprojektion sind erst verfügbar, wenn das Betriebssystem den RASCS_Projected Zustand für die Remotezugriffsverbindung ausgeführt hat. Wenn RasGetProjectionInfoEx vor dem RASCS_Projected-Zustand aufgerufen wird, wird ERROR_PROJECTION_NOT_COMPLETE zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll

Weitere Informationen

Ras-Dienst (Ras) – Übersicht

Funktionen des RAS-Diensts