INetConnection::GetProperties メソッド (netcon.h)
[以降のバージョンでは、インターネット接続ファイアウォールが変更または使用できない場合があります。 代わりに、 Windows ファイアウォール API を使用します。
GetProperties メソッドは、このネットワーク接続のプロパティを含む構造体を取得します。
構文
HRESULT GetProperties(
[out] NETCON_PROPERTIES **ppProps
);
パラメーター
[out] ppProps
正常に戻った場合に、このネットワーク接続のプロパティを含む NETCON_PROPERTIES 構造体を指すポインターへのポインター。
戻り値
メソッドが成功した場合、戻り値はS_OK。
メソッドが失敗した場合、戻り値は次のいずれかのエラー コードになります。
| リターン コード | 説明 |
|---|---|
|
操作が中止されました。 |
|
未指定のエラーが発生しました。 |
|
いずれかのパラメーターが無効です。 |
|
指定されたインターフェイスはサポートされていません。 |
|
指定したメソッドは実装されていません。 |
|
メソッドで必要なメモリを割り当てることができませんでした。 |
|
パラメーターとして渡されたポインターが無効です。 |
|
不明な理由でメソッドが失敗しました。 |
注釈
呼び出し元のアプリケーションは、GetProperties によって返されるNETCON_PROPERTIES構造体によって占有されるメモリを解放する必要があります。 NcFreeNetconProperties 関数を呼び出してメモリを解放します。 この関数は NetCon.h で定義され、NetShell.dll によってエクスポートされます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | netcon.h |
| [DLL] | Hnetcfg.dll |