PREGISTER_PROTOCOL回呼函式 (routprot.h)

RegisterProtocol 函式會向路由器管理員註冊路由通訊協定。 它也會通知路由器管理員路由通訊協議支援的功能。

語法

PREGISTER_PROTOCOL PregisterProtocol;

DWORD PregisterProtocol(
  [in, out] PMPR_ROUTING_CHARACTERISTICS pRoutingChar,
  [in, out] PMPR_SERVICE_CHARACTERISTICS pServiceChar
)
{...}

參數

[in, out] pRoutingChar

在輸入時，指向 MPR_ROUTING_CHARACTERISTICS 結構的指標。

在輸出上，接收針對路由通訊協議實作之函式的指標。

如需如何與 RegisterProtocol 函式搭配使用的詳細資訊，請參閱MPR_ROUTING_CHARACTERISTICS結構的參考頁面。

[in, out] pServiceChar

在輸入上， 指向MPR_SERVICE_CHARACTERISTICS 結構的指標。

在輸出上，接收針對路由通訊協議實作之函式的指標。

如需如何與 RegisterProtocol 函式搭配使用的詳細資訊，請參閱 MPR_SERVICE_CHARACTERISTICS 結構的參考頁面。

傳回值

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

如果函式失敗，傳回值會ERROR_NOT_SUPPORTED。

備註

所有路由通訊協定 DLL 都必須填入 MPR_ROUTING_CHARACTERISTICS 結構的值。

提供服務的路由通訊協定 DLL 必須填入 MPR_SERVICE_CHARACTERISTICS 結構的值。 如果路由通訊協定 DLL 未提供服務，它應該為此結構的 fSupportedFunctionality 成員填入零，但不需要填入其他成員的值。

路由通訊協定會在使用者模式 DLL 中實作。 單一 DLL 可以實作多個路由通訊協定。 因此，路由器管理員可能會針對 DLL 中實作的每個路由通訊協定呼叫 RegisterProtocol 多次。

規格需求

另請參閱

MPR_ROUTING_CHARACTERISTICS

MPR_SERVICE_CHARACTERISTICS

路由通訊協定介面函式

路由通訊協定介面參考