MprAdminInterfaceDeviceSetInfo 函式 (mprapi.h)

MprAdminInterfaceDeviceSetInfo 會建立或修改路由器需求撥號介面中使用的裝置。

語法

DWORD MprAdminInterfaceDeviceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwIndex,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

參數

[in] hMprServer

處理要在其中執行此呼叫的路由器。藉由呼叫 MprAdminServerConnect 來取得此句柄。

[in] hInterface

介面的句柄。從先前呼叫 MprAdminInterfaceCreate，或呼叫 MprAdminInterfaceEnum 來取得這個句柄。

[in] dwIndex

指定裝置的單一型索引。多連結需求撥號介面會使用多個裝置。

[in] dwLevel

DWORD 值，描述資訊在 lplpBuffer 參數中結構化的格式。 dwLevel 可接受的值為 0 或 1，如下表所列。

值	結構格式
0	MPR_DEVICE_0
1	MPR_DEVICE_1

[in] lpbBuffer

MPR_DEVICE_0或MPR_DEVICE_1結構的指標。 dwLevel 參數會指出結構的型別。

傳回值

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

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

值	意義
ERROR_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE	hInterface 值無效。
ERROR_INVALID_PARAMETER	lplpBuffer 參數為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NOT_SUPPORTED	dwLevel 值無效。

規格需求

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