PFNRASRECEIVEBUFFER 回呼函式 (ras.h)
自訂腳本 DLL 會呼叫 RasReceiveBuffer 函 式，通知 RAS 已準備好透過指定的埠從伺服器接收資料。
PFNRASRECEIVEBUFFER類型會定義這個回呼函式的指標。 RasReceiveBuffer 是應用程式定義函數名稱的預留位置。
語法
PFNRASRECEIVEBUFFER Pfnrasreceivebuffer;
DWORD Pfnrasreceivebuffer(
HANDLE hPort,
PBYTE pBuffer,
PDWORD pdwSize,
DWORD dwTimeOut,
HANDLE hEvent
)
{...}
參數
hPort
要接收資料的埠控制碼。 此控制碼應該是 RAS 傳入的控制碼，作為 RasCustomScriptExecute 函式的第一個參數。
pBuffer
緩衝區的指標，從 hPort 參數所指定的埠接收資料。 使用 RasGetBuffer 函 式取得此緩衝區。
pdwSize
DWORD變數的指標，該變數會接收pBuffer參數所指向之緩衝區中傳回的資料大小。
dwTimeOut
hEvent
當收到的資料可用時，RAS 會發出訊號的事件物件控制碼。
傳回值
如果函式成功，傳回值會 ERROR_SUCCESS。
如果函式失敗，傳回值可以是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
在 pBuffer參數中傳遞之緩衝區的指標無效。 |
|
hPort參數指定的控制碼無效。 |
備註
RasReceiveBuffer 是非同步函式。 RasReceiveBuffer 會立即傳回，即使資料尚無法使用也一樣。 自訂腳本 DLL 必須等候 hEvent 參數所指定的事件物件。 當資料可用時，RAS 會發出此事件的訊號。 然後，自訂腳本 DLL 應該呼叫 RasRetrieveBuffer 函 式來取得資料。 自訂腳本 DLL 可能會在RasRetrieveBuffer 中傳遞它傳入 RasReceiveBuffer的相同緩衝區指標。
如果基於某些原因，RAS 也會發出事件物件的訊號，該埠會在資料張貼之前中斷連線。 在此情況下， RasRetrieveBuffer 會傳回 Raserror.h 中定義的錯誤，指出失敗的原因。
自訂腳本 DLL 會透過函式指標呼叫 RasReceiveBuffer 。 當 RAS 呼叫 RAsCustomScriptExecute的 DLL 實作時，函式指標會以參數的形式傳遞至自訂腳本 DLL。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ras.h |