NetAddr_GetAddress マクロ (shellapi.h)

ネットワーク アドレスが指定した型と形式に準拠しているかどうかを示します。

構文

void NetAddr_GetAddress(
             hwnd,
  [in, out]  pv
);

パラメーター

hwnd

検証するアドレスを含むネットワーク アドレス コントロールへのハンドル。

[in, out] pv

hwnd で指定されたコントロールのアドレス形式と型が検証されている場合に、解析された形式でネットワーク アドレス情報を受け取るNC_ADDRESS構造体へのポインター。 呼び出し元のアプリケーションは、この構造体のメモリを割り当てる役割を担います。

戻り値

なし

解説

NetAddr_GetAddress マクロを使用して、ネットワーク アドレス コントロール内のネットワーク アドレスを、事前設定されたネットワーク アドレスの種類マスクに対して検証します。 インスタンス化するには、Shellapi.h で定義 msctls_netaddress クラスを使用します。 このマクロを呼び出す前に、実行時に InitNetworkAddressControl を呼び出します。 これにより、ネットワーク アドレス コントロールを含む共通コントロール ライブラリが初期化されます。

このマクロは、ネットワーク アドレス コントロールからネットワーク アドレス文字列を取得し、文字列を解析し、文字列がネットワーク アドレスの種類マスクと一致するかどうかを確認します。 文字列が mask と一致する場合、関数は S_OKを返し、pv が指すNC_ADDRESS構造体を使用して、解析された形式で文字列を呼び出し元のアプリケーション (ポート番号、プレフィックスの長さ、およびその他のアドレス情報を含む) に返します。 このマクロは、呼び出し元のアプリケーションが pv が指す構造体の割り当てに失敗した場合に、E_INVALIDARGを返します。

サービスとネットワークのインターネット プロトコル (IP) アドレス バージョン 4 および 6 (v4/v6) と、ドメイン ネーム システム (DNS) 形式を使用した名前付きインターネット アドレスとサービスの表現が解析されます。 ネットワーク アドレス文字列が名前付きホスト名 (DNS) またはサービスを表す場合、NC_ADDRESS の PrefixLength メンバーで返される値は 0 です。

NetAddr_GetAddress マクロを呼び出す前に、NetAddr_SetAllowType マクロを使用してネットワーク アドレスの種類マスクを設定します。

要件

関連項目

NetAddr_GetAllowType