次の方法で共有

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

デバイスの 1 から始まるインデックスを指定します。 マルチリンクされた需要ダイヤル インターフェイスでは、複数のデバイスが使用されます。

[in] dwLevel

lplpBuffer パラメーターで情報が返される形式を表す DWORD 値。 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
Library Mprapi.lib
[DLL] Mprapi.dll

関連項目

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceSetInfo