Freigeben über


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