NCM_GETADDRESS メッセージ
ネットワーク アドレスが指定した型と形式に準拠しているかどうかを示します。
NCM_GETADDRESS
wParam = (WPARAM) (PNC_ADDRESS) pv;
lParam = 0;
パラメーター
-
wParam
- ゼロを指定してください。
-
pv [in, out]
- *hwnd* で指定されたコントロールのアドレス形式と型が検証されている場合に、解析された形式でネットワーク アドレス情報を受け取る NC_ADDRESS構造体への ポインター。 呼び出し元のアプリケーションは、この構造体のメモリを割り当てる役割を担います。
戻り値
HRESULT 型の次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
呼び出し元のアプリケーションが NC_ADDRESS 構造体を割り当てませんでした。 |
|
出力バッファーが小さすぎて、解析されたネットワーク アドレスを保持できません。 |
|
ネットワーク アドレス文字列は、指定された型ではありません。 |
|
操作に成功しました。 |
|
検証するネットワーク アドレス コントロールにアドレスがありません。 |
注釈
NCM_GETADDRESS メッセージを使用して、ネットワーク アドレス コントロール内のネットワーク アドレスを、事前設定されたネットワーク アドレスの種類マスクに対して検証します。 インスタンス化するには、Shellapi.h で定義 msctls_netaddress クラスを使用します。 このメッセージを送信する前に、実行時に InitNetworkAddressControl を呼び出します。 これにより、ネットワーク アドレス コントロールを含む共通コントロール ライブラリが初期化されます。
このメッセージは、ネットワーク アドレス コントロールからネットワーク アドレス文字列を取得し、文字列を解析し、文字列がネットワーク アドレスの種類マスクと一致するかどうかを確認します。 文字列がマスクと一致する場合、メッセージは S_OKを返し、pv が指すNC_ADDRESS構造体を使用して、解析された形式の文字列を呼び出し元のアプリケーション (ポート番号、プレフィックスの長さ、その他のアドレス情報を含む) に返します。 このメッセージは、呼び出し元のアプリケーションが pv が指す構造体の割り当てに失敗した場合に、E_INVALIDARGを返します。
サービスとネットワークのインターネット プロトコル (IP) アドレス バージョン 4 および 6 (v4/v6) と、ドメイン ネーム システム (DNS) 形式を使用した名前付きインターネット アドレスとサービスの表現が解析されます。 ネットワーク アドレス文字列が名前付きホスト名 (DNS) またはサービスを表す場合、NC_ADDRESS の PrefixLength メンバーで返される値は 0 です。
NCM_GETADDRESS マクロを送信する前に 、NCM_SETALLOWTYPE メッセージを使用してネットワーク アドレスの種類マスク を 設定します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
Header |
|
こちらもご覧ください