GetIpStatistics を使用した情報の取得

GetIpStatistics 関数は、MIB_IPSTATS構造体へのポインターに、システムに関連付けられている現在の IP 統計に関する情報を入力します。

GetIpStatistics を使用するには

1. 必要な変数をいくつか宣言します。

   エラー チェック関数の呼び出しに使用する DWORD 変数 dwRetval を宣言します。 pStats というMIB_IPSTATS変数へのポインターを宣言し、構造体にメモリを割り当てます。 メモリが割り当て可能であることを確認します。

   MIB_IPSTATS  *pStats;
   DWORD        dwRetVal = 0;
   
   pStats = (MIB_IPSTATS*) malloc(sizeof(MIB_IPSTATS));
   
   if (pStats == NULL) {
       printf("Unable to allocate memory for MIB_IPSTATS\n");
   }
   

2. pStats パラメーターを指定して GetIpStatistics 関数を呼び出して、ローカル コンピューターの IP 統計情報を取得します。 エラーを確認し、 DWORD 変数 dwRetvalにエラー値を返します。 エラーが発生した場合は、変数を dwRetval 使用して、より広範なエラー チェックとレポートを行うことができます。

   dwRetVal = GetIpStatistics(pStats);
   if (dwRetVal != NO_ERROR) {
       printf("GetIpStatistics call failed with %d\n", dwRetVal);
   }
   

3. GetIpStatistics の呼び出しが成功した場合は、pStats パラメーターが指すMIB_IPSTATS構造体のデータの一部を出力します。

   printf("Number of interfaces:   %ld\n", pStats->dwNumIf);
   printf("Number of IP addresses: %ld\n", pStats->dwNumAddr);
   printf("Number of received datagrams:  %ld\n", pStats->dwInReceives);
   printf("NUmber of outgoing datagrams requested to transmit:  %ld\n", pStats->dwOutRequests);
   

4. pStats パラメーターが指すMIB_IPSTATS構造体に割り当てられたメモリを解放します。 これは、 アプリケーションで pStats パラメーターによって返されるデータが不要になったら行う必要があります。

   if (pStats)
       free(pStats);
   

次の手順: GetTcpStatistics を使用した情報の取得

前の手順: AddIPAddress と DeleteIPAddress を使用した IP アドレスの管理