MprAdminTransportSetInfo 函式 (mprapi.h)

MprAdminTransportSetInfo函式會設定指定傳輸的全域資訊或預設用戶端介面資訊或兩者。

語法

DWORD MprAdminTransportSetInfo(
  [in]           MPR_SERVER_HANDLE hMprServer,
  [in]           DWORD             dwTransportId,
  [in, optional] LPBYTE            pGlobalInfo,
  [in]           DWORD             dwGlobalInfoSize,
  [in, optional] LPBYTE            pClientInterfaceInfo,
  [in]           DWORD             dwClientInterfaceInfoSize
);

參數

[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] pGlobalInfo

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

這是選擇性參數。 如果呼叫的應用程式指定此參數的 Null ，則函式不會設定全域資訊。

[in] dwGlobalInfoSize

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

[in, optional] pClientInterfaceInfo

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

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

[in] dwClientInterfaceInfoSize

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

傳回值

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

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

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

需求

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

另請參閱

MprAdminServerConnect

MprAdminTransportGetInfo

路由器管理功能

路由器管理參考