MprAdminPortGetInfo 関数 (mprapi.h)

  • [アーティクル]

MprAdminPortGetInfo 関数は、特定のポートの情報を取得します。

構文

DWORD MprAdminPortGetInfo(
  [in]  RAS_SERVER_HANDLE hRasServer,
  [in]  DWORD             dwLevel,
  [in]  HANDLE            hPort,
  [out] LPBYTE            *lplpbBuffer
);

パラメーター

[in] hRasServer

ポート情報を収集する RAS サーバー コンピューターを処理します。 MprAdminServerConnect を呼び出して、このハンドルを取得します。

[in] dwLevel

lplpbBuffer パラメーターで情報が返される形式を表す DWORD 値。 dwLevel に使用できる値は、次の表に示すように 0 と 1 です。

値 構造体の形式
0 RAS_PORT_0
1 RAS_PORT_1

[in] hPort

情報を収集するポートを処理します。 MprAdminPortEnum を呼び出して、このハンドルを取得します。

[out] lplpbBuffer

正常に完了すると、ポートを記述する構造体へのポインター。 これらの構造体は、dwLevel パラメーターの値に応じてRAS_PORT_0型またはRAS_PORT_1型です。 MprAdminBufferFree を呼び出して、このメモリを解放します。

戻り値

関数が成功した場合、戻り値は NO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

値 意味
ERROR_ACCESS_DENIED
 呼び出し元アプリケーションに十分な特権がありません。
ERROR_DDM_NOT_RUNNING
 ダイナミック インターフェイス マネージャー (DIM) が LAN でのみ実行されるように構成されている可能性があるため、Demand Dial Manager (DDM) が実行されていません。
ERROR_INVALID_PARAMETER
 次のパラメーターの少なくとも 1 つが NULL であるか、有効なメモリを指していません: lplpBuffer、 lpdwEntriesRead、または lpdwTotalEntries。
ERROR_INVALID_PORT_HANDLE
 hPort パラメーターが無効です。
ERROR_NOT_SUPPORTED
 dwLevel パラメーターは 0 ではありません。
その他
 MprError.h、RasError.h、または WinError.h からのエラー。
 
 

注釈

この関数は、RRAS 再頒布可能パッケージがインストールされている場合、Windows NT 4.0 で使用できます。 ただし、RRAS 再頒布可能パッケージに付属する Mprapi.dll のバージョンでは、関数は MprAdminPortGetInfo ではなく RasAdminPortGetInfo としてエクスポート されます。 したがって、RRAS 再頒布可能パッケージを使用する場合は、 LoadLibrary と GetProcAddress を 使用してこの関数にアクセスします。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mprapi.h
Library Mprapi.lib
[DLL] Mprapi.dll

こちらもご覧ください

MprAdminBufferFree

MprAdminPortEnum

MprAdminServerConnect

RAS 管理関数

リモート アクセス サービス管理リファレンス