次の方法で共有


NCM_GETADDRESS メッセージ

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

NCM_GETADDRESS

    wParam = (WPARAM) (PNC_ADDRESS) pv;

    lParam = 0;            

            

パラメーター

wParam

ゼロを指定してください。

pv [in, out]

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

戻り値

HRESULT 型の次のいずれかの値を返します。

リターン コード 説明
E_INVALIDARG
呼び出し元のアプリケーションが NC_ADDRESS 構造体を割り当てませんでした。
ERROR_INSUFFICIENT_BUFFER
出力バッファーが小さすぎて、解析されたネットワーク アドレスを保持できません。
ERROR_INVALID_PARAMETER
ネットワーク アドレス文字列は、指定された型ではありません。
ERROR_SUCCESS
操作に成功しました。
S_FALSE
検証するネットワーク アドレス コントロールにアドレスがありません。

 

注釈

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

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

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

NCM_GETADDRESS マクロを送信する前に 、NCM_SETALLOWTYPE メッセージを使用してネットワーク アドレスの種類マスク 設定します。

要件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2008 [デスクトップ アプリのみ]
Header
Shellapi.h

こちらもご覧ください

NCM_GETALLOWTYPE

NetAddr_GetAddress