MprConfigTransportCreate 函式 (mprapi.h)
MprConfigTransportCreate函式會將指定的傳輸新增至指定的路由器組態中存在的傳輸通訊協定清單。
語法
DWORD MprConfigTransportCreate(
[in] HANDLE hMprConfig,
[in] DWORD dwTransportId,
[in, optional] LPWSTR lpwsTransportName,
[in] LPBYTE pGlobalInfo,
[in] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in, optional] DWORD dwClientInterfaceInfoSize,
[in, optional] LPWSTR lpwsDLLPath,
[out] HANDLE *phRouterTransport
);
參數
[in] hMprConfig
要新增傳輸的路由器組態控制碼。 呼叫 MprConfigServerConnect以取得此控制碼。
[in] dwTransportId
DWORD值，描述要新增至組態的傳輸。 此參數也會識別傳輸的路由器管理員。 下表列出 dwTransportId 可接受的值。
| 值 | 傳輸 (通訊協定系列) |
|---|---|
| PID_ATALK | AppleTalk |
| PID_IP | 網際網路通訊協定第 4 版 |
| PID_IPX | 網際網路封包交換 |
| PID_NBF | NetBIOS 框架通訊協定 |
| PID_IPV6 | Windows Server 2008 或更新版本：網際網路通訊協定第 6 版 |
[in, optional] lpwsTransportName
Null終止 Unicode 字串的指標，指定要加入之傳輸的名稱。 如果未指定此參數， dwTransportId 參數會轉換成字串，並作為傳輸名稱使用。
[in] pGlobalInfo
指定傳輸全域資訊之資訊標頭的指標。 傳輸的路由器管理員會解譯這項資訊。 使用 資訊標頭函式 來管理資訊標頭。
[in] dwGlobalInfoSize
指定 pGlobalInfo 參數所指向之資料的大小，以位元組為單位。
[in, optional] pClientInterfaceInfo
指定用戶端路由器預設介面資訊的資訊標頭指標。 這項資訊可用來設定此傳輸之用戶端路由器的動態介面。 使用 資訊標頭函式 來管理資訊標頭。
此參數是選擇性的;呼叫的應用程式可以指定此參數的 Null 。
[in, optional] dwClientInterfaceInfoSize
指定 pClientInterfaceInfo 參數所指向之資料的大小，以位元組為單位。 如果呼叫應用程式為pClientInterfaceInfo指定Null，則呼叫應用程式應該為此參數指定零。
[in, optional] lpwsDLLPath
指定指定指定傳輸之路由器管理員 DLL 名稱之 Null終止 Unicode 字串的指標。 如果指定此名稱，函式會將此傳輸的 DLL 路徑設定為此名稱。
此參數是選擇性的;呼叫的應用程式可以指定此參數的 Null 。
[out] phRouterTransport
的指標
HANDLE 變數，接收 dwTransportId 參數中所指出的傳輸組態控制碼類型。
傳回值
如果函式成功，傳回值會NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
hMprConfig參數為Null，或phRouterTransport參數為Null，或兩者都是Null。 |
|
資源不足，無法完成作業。 |
|
使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。 |
備註
如果指定的傳輸已經存在， MprConfigTransportCreate 會使用提供的參數值，執行 MprConfigTransportSetInfo 呼叫的對等作業。
需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mprapi.h |
| 程式庫 | Mprapi.lib |
| Dll | Mprapi.dll |