共用方式為

MprAdminTransportCreate 函式 (mprapi.h)

  • 發行項

MprAdminTransportCreate 函式會載入新的傳輸，並啟動傳輸的路由器管理員。

語法

DWORD MprAdminTransportCreate(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPWSTR            lpwsTransportName,
  [in]           LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in, optional] DWORD             dwClientInterfaceInfoSize,
  [in]           LPWSTR            lpwsDLLPath
);

參數

[in] hMprServer

處理要設定資訊的路由器。 藉由呼叫 MprAdminServerConnect 來取得此句柄。

[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 字串的指標。

[in] pGlobalInfo

緩衝區的指標，指定傳輸的全域資訊。 使用 資訊標頭函式 來管理信息標頭。

[in] dwGlobalInfoSize

指定 pGlobalInfo 參數所指向之數據的大小，以位元組為單位。

[in, optional] pClientInterfaceInfo

緩衝區的指標，指定傳輸的預設用戶端介面資訊。

這是選擇性參數。 如果呼叫的應用程式指定此參數的 NULL ，則函式不會設定預設用戶端介面資訊。

[in, optional] dwClientInterfaceInfoSize

指定 pClientInterfaceInfo 參數所指向之緩衝區的大小，以位元組為單位。

[in] lpwsDLLPath

Null 終止 Unicode 字串的指標，指定傳輸之 DLL 的路徑。

傳回值

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

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

值 意義
ERROR_ACCESS_DENIED
 呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_PARAMETER
 pGlobalInfo 參數和 pClientInterfaceInfo 參數都是 NULL。
ERROR_NOT_ENOUGH_MEMORY
 資源不足，無法完成作業。
ERROR_PROTOCOL_ALREADY_INSTALLED
 指定的傳輸已在指定的路由器上執行。
ERROR_UNKNOWN_PROTOCOL_ID
 dwTransportId 值不符合任何支援的傳輸通訊協定。

規格需求

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

另請參閱

MprAdminTransportGetInfo

MprAdminTransportSetInfo