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

另請參閱

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceGetInfo