RasAdminPortGetInfo 関数
[この関数は、Windows NT Server 4.0 との下位互換性のためにのみ提供されます。 Windows Server 2003 でERROR_CALL_NOT_IMPLEMENTEDを返します。 アプリケーションでは MprAdminPortGetInfo 関数を 使用する必要があります。
RasAdminPortGetInfo 関数は、指定したサーバー上の指定されたポートに関する情報を取得します。
構文
DWORD RasAdminPortGetInfo(
_In_ const WCHAR *lpszServer,
_In_ const WCHAR *lpszPort,
_Out_ RAS_PORT_1 *pRasPort1,
_Out_ RAS_PORT_STATISTICS *pRasStats,
_Out_ RAS_PARAMETERS **ppRasParams
);
パラメーター
-
lpszServer [in]
-
RAS サーバーの名前を指定する null で終わる Unicode 文字列へのポインター。 先頭に "\\" 文字を付け、\\servername という形式で名前を指定します。
-
lpszPort [in]
-
サーバー上のポートの名前を指定する null で終わる Unicode 文字列へのポインター。
-
pRasPort1 [out]
-
関数がポートの状態に関する情報を入力する RAS_PORT_1 構造体へのポインター。
-
pRasStats [out]
-
関数がポートに関する統計情報を入力する RAS_PORT_STATISTICS 構造体へのポインター。
-
ppRasParams [out]
-
構造体の配列のアドレスを受け取るポインター変数 へのポインター RAS_PARAMETERS 。 各構造体には、MAXCONNECTBPS などのメディア固有のキーの名前とそれに関連付けられている値が含まれます。 アプリケーションがこのメモリで終了したら、 RasAdminFreeBuffer 関数を呼び出して解放します。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値には次のいずれかのエラー コードを指定できます。
| 値 | 説明 |
|---|---|
|
指定されたポートが無効です。 |
|
ppRasParams 配列のバッファーを割り当てるためのメモリ不足。 |
この関数の拡張エラー情報はありません。 GetLastError を呼び出さないでください。
要件
| 要件 | 値 |
|---|---|
| クライアント サポートの終了 |
Windows 2000 Professional |
| サーバー サポートの終了 |
Windows 2000 Server |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|