MprAdminInterfaceDeviceGetInfo 函式 (mprapi.h)

  • 發行項

MprAdminInterfaceDeviceGetInfo會擷取路由器需求撥號介面中使用的裝置相關資訊。

語法

DWORD MprAdminInterfaceDeviceGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwIndex,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpBuffer
);

參數

[in] hMprServer

要在其中執行此呼叫的路由器控制碼。 呼叫 MprAdminServerConnect以取得此控制碼。

[in] hInterface

介面的控制碼。 從先前呼叫MprAdminInterfaceCreate或呼叫MprAdminInterfaceEnum取得此控制碼

[in] dwIndex

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

[in] dwLevel

DWORD 值，描述 lplpBuffer 參數中傳回信息的格式。 dwLevel可接受的值包括 0 或 1，如下表所列。

值 結構格式
0 MPR_DEVICE_0
1 MPR_DEVICE_1

[out] lplpBuffer

成功完成時， 指向MPR_DEVICE_0 或 MPR_DEVICE_1 結構的指標。 dwLevel參數表示 結構的類型。 呼叫 MprAdminBufferFree來釋放此記憶體。

傳回值

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

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

值 意義
ERROR_ACCESS_DENIED
 呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE
 hInterface值無效。
ERROR_INVALID_PARAMETER
 lplpbBuffer參數為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

MprAdminInterfaceDeviceSetInfo