ParseNetworkString

入力ネットワーク文字列を解析し、指定した IP ネットワーク文字列型の正当な表現であるかを確認する。一致すれば任意で解析結果を返せる。

ParseNetworkString NetworkString, Types, AddressInfo, PortNumber, PrefixLength

NetworkString : [wstr] 解析する NULL 終端のネットワーク文字列へのポインタ。
Types : [int] 解析する IP ネットワーク文字列の種別。このパラメータは Iphlpapi.h ヘッダで定義されるネットワーク文字列種別の一つである。
AddressInfo : [var] 成功時、NULL 以外のポインタが渡されていれば、解析された IP アドレス情報を含む NET_ADDRESS_INFO 構造体へのポインタを返す。
PortNumber : [var] 成功時、NULL 以外のポインタが渡されていれば、解析されたネットワークポート (ホストバイト順) へのポインタを返す。NetworkString にポートが含まれていない場合は 0 を指すポインタが返される。
PrefixLength : [var] 成功時、NULL 以外のポインタが渡されていれば、解析されたプレフィックス長へのポインタを返す。NetworkString にプレフィックスが含まれていない場合は -1 を指すポインタが返される。

(プラグイン / モジュール : iphlpapi.dll)

解説

入力ネットワーク文字列を解析し、指定した IP ネットワーク文字列型の正当な表現であるかを確認する。一致すれば任意で解析結果を返せる。

[戻り値]
関数が成功すると、戻り値は ERROR_SUCCESS である。失敗した場合は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
ParseNetworkString 関数は NetworkString に渡された入力ネットワーク文字列を解析し、Types
で指定した文字列種別の正当な表現であるかを確認する。一致すれば成功し、AddressInfo / PortNumber /
PrefixLength が NULL 以外ならそこに結果を返す。IPv4 / IPv6 アドレス、サービス、ネットワーク表現、および
DNS 名を用いた名前付きインターネットアドレス/サービスを解析できる。
AddressInfo が指す NET_ADDRESS_INFO 構造体について、SOCKADDR_IN および SOCKADDR は
Ws2def.h (Winsock2.h から自動インクルード) で定義される。SOCKADDR_IN6 は Ws2ipdef.h
(Ws2tcpip.h から自動インクルード) で定義される。ParseNetworkString と NET_ADDRESS_INFO
を使用するには、Winsock2.h と Ws2tcpip.h を Iphlpapi.h より前にインクルードする必要がある。

情報