routproc

routproc 函式是範例路由程式。 它必須作為應用程式的一部分提供。 動態存取模組 (DMOD) 呼叫此應用程式時，DMOD 會接著呼叫路由程式，直到一個接受訊息為止。

語法

  
DWORD routproc(   
BUFHDR *msgptr,   
USHORT locl,   
USHORT retstat   
);  

參數

msgptr
DMOD 傳遞至路由程式的訊息指標。

locl
如果 retstat 指出傳回的訊息) ，或如果 retstat 指出路徑錯誤) ，則從中接收訊息 (位置，或路徑遺失位置 (。

retstat
話叫的原因：

CEDINMSG (1) — 傳回的訊息。

CEDINLLN (2) — 路徑錯誤 (請參閱下面的) 。

傳回值

TRUE
路由程式已接受訊息。

false
訊息不適用於此路由程式。

備註

路由程序應該先呼叫 sbpurcvx，以處理任何 Open 回應消息，如下所示：

sbpurcvx (&msgptr， locl， retstat)

sbpurcvx 傳回 TRUE 的傳回碼表示 sbpurcvx 已接受訊息;已收到此應用程式的 Open 錯誤回應，且資源位置正在繼續。 路由程式不應進一步處理訊息，而且應該傳回 TRUE 以防止 DMOD 呼叫進一步的路由程式。

sbpurcvx 的 FALSE 傳回碼表示路由程序應該：

• 如果訊息適用於此應用程式，請負責訊息並傳回 TRUE ，以防止 DMOD 呼叫進一步路由程式。

• 如果訊息不適用於此應用程式，請傳回 FALSE ，讓 DMOD 嘗試進一步的路由程式。

  如果傳回路徑錯誤， msgptr 將不會指向有效的訊息，而且不會再傳回 FMI () 訊息的函式管理介面，以取得指出的地區設定值。 應用程式負責使用此位置結束所有會話。 路由程式必須傳回 FALSE。 這可確保遺失位置會回報給所有其他路由程式。

  如果訊息適用於此應用程式，路由程式可以立即處理訊息，或將訊息放在應用程式佇列上，然後使用號誌張貼應用程式。 如需詳細資訊，請參閱 接收訊息。