共用方式為

PSTART_PROTOCOL回呼函式 (routprot.h)

  • 發行項

StartProtocol 函式會初始化路由協定的功能。 路由器管理員會使用此函式來傳遞路由通訊協定全域組態參數和一組 API 進入點。 通訊協定會使用這些進入點來呼叫路由器管理員。

語法

PSTART_PROTOCOL PstartProtocol;

DWORD PstartProtocol(
  [in] HANDLE NotificationEvent,
  [in] PSUPPORT_FUNCTIONS SupportFunctions,
  [in] LPVOID GlobalInfo,
  [in] ULONG StructureVersion,
  [in] ULONG StructureSize,
  [in] ULONG StructureCount
)
{...}

參數

[in] NotificationEvent

事件物件的句柄。 當路由通訊協定想要路由器管理員從通訊協定所維護的佇列中擷取異步訊息時，路由通訊協定會發出此事件的訊號。

[in] SupportFunctions

SUPPORT_FUNCTIONS 結構的指標。 此結構的欄位是路由器管理員中函式的指標。 這些函式允許通訊協定存取跨越路由協議的資訊。

[in] GlobalInfo

通訊協議定義的全域指標，而不是介面特定的組態資訊。 此資訊是路由通訊協定的私人資訊。

[in] StructureVersion

指定 GlobalInfo 參數所指向的信息結構版本。 在某些情況下，這等於路由通訊協定的版本。

[in] StructureSize

指定 GlobalInfo 參數所指向之每個資訊結構的大小。 由於某些資訊結構包含可變長度成員，因此路由通訊協定不一定能夠判斷版本的資訊大小。

[in] StructureCount

指定 GlobalInfo 參數所指向的信息結構數目計數。 此參數一律為一個。

傳回值

如果函式成功，且通訊協定已準備好接收介面資訊，則會NO_ERROR傳回值。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值 Description
ERROR_CAN_NOT_COMPLETE
 嘗試初始化路由通訊協議失敗。
ERROR_INVALID_PARAMETER
 GlobalInfo 參數所指向的其中一個參數無效。
 
 

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 routprot.h

另請參閱

GetEventMessage

路由通訊協定介面函式

路由通訊協定介面參考

SUPPORT_FUNCTIONS

StopProtocol