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 マクロを使用してネットワーク アドレスの種類マスクを設定します。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shellapi.h |