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 |
|---|---|
|
Der Puffer, auf den pRasProjection verweist, ist nicht groß genug, um die angeforderten Informationen zu enthalten. |
|
Der hrasconn-Parameter ist kein gültiges Handle. |
|
Die Funktion wurde mit einem ungültigen Parameter aufgerufen. |
|
Das dwSize-Element der Struktur, auf die von pRasProjection verwiesen wird, gibt eine ungültige Größe an. |
|
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 |