GetNumberOfInterfaces 関数 (iphlpapi.h)

GetNumberOfInterfaces 関数は、ローカル コンピューター上のインターフェイスの数を取得します。

構文

IPHLPAPI_DLL_LINKAGE DWORD GetNumberOfInterfaces(
  [out] PDWORD pdwNumIf
);

パラメーター

[out] pdwNumIf

ローカル コンピューター上のインターフェイスの数を受け取る DWORD 変数へのポインター。

戻り値

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

関数が失敗した場合は、 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

解説

GetNumberOfInterfaces 関数は、ループバック インターフェイスを含むローカル コンピューター上のインターフェイスの数を返します。 これらの関数はループバック インターフェイスに関する情報を返さないため、この数は GetAdaptersInfo 関数と GetInterfaceInfo 関数によって返されるアダプターの数よりも 1 つ多くなります。

要件

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

関連項目

GetAdaptersInfo

GetIfEntry

GetInterfaceInfo

IP ヘルパー関数リファレンス

IP ヘルパーの開始ページ