RasGetProjectionInfoEx 函式 (ras.h)

  • 發行項

RasGetProjectionInfoEx 函式會取得點對點通訊協定 (PPP) 或因特網密鑰交換第 2 版 (IKEv2) 本機用戶端上所有 RAS 連線的遠端存取投影作業的相關信息。

語法

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

參數

[in] hrasconn

要變更通道端點的 RAS 連線句柄。 這可以是 RasDial 或 RasEnumConnections 函式所傳回的句柄。

[in, out] pRasProjection

RAS_PROJECTION_INFO 結構的指標，可接收 RAS 連線的投影資訊。

[in, out] lpdwSize

輸入中的指標，指定 pRasProjection 所指向緩衝區的大小，以位元組為單位。 在輸出時，此變數會接收儲存 pRasProjection 所指向之RAS_PROJECTION_INFO結構數目所需的緩衝區大小，以位元組為單位。

傳回值

如果函式成功，傳回值會 ERROR_SUCCESS。

如果函式失敗，則傳回值是下列其中一個錯誤碼，或 來自路由和遠端訪問錯誤碼 或 Winerror.h 的值。

值 意義
ERROR_BUFFER_TOO_SMALL
 pRasProjection 所指向的緩衝區不夠大，無法包含要求的資訊。
ERROR_INVALID_HANDLE
 hrasconn 參數不是有效的句柄。
ERROR_INVALID_PARAMETER
 函式是以無效的參數呼叫。
ERROR_INVALID_SIZE
 pRasProjection 所指向結構的 dwSize 成員指定了無效的大小。
ERROR_PROTOCOL_NOT_CONFIGURED
 要求資訊的控制通訊協定未成功或失敗，因為連線的電話簿專案不需要嘗試交涉通訊協定。

備註

遠端存取投影是遠端存取伺服器和遠端用戶端交涉網路協定特定資訊的程式。 遠端存取伺服器會使用此網路通訊協定特定資訊來代表網路上的遠端用戶端。

除非操作系統已在遠端訪問連線上執行 RASCS_Projected 狀態，否則無法使用遠端訪問投影資訊。 如果在RASCS_Projected狀態之前呼叫 RasGetProjectionInfoEx，則會傳回ERROR_PROJECTION_NOT_COMPLETE。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 ras.h
程式庫 Rasapi32.lib
Dll Rasapi32.dll

另請參閱

遠端訪問服務 (RAS) 概觀

遠端存取服務函式