WNet 関数
Windows ネットワーク関数は、ネットワーク リソースを管理するための情報とユーティリティを提供します。 Windows ネットワーク機能は、次のようにグループ化できます。
接続関数
次の WNet 接続関数を呼び出して、ローカル デバイスをネットワーク リソースに接続し、ネットワーク接続をキャンセルします。
| 機能 | 説明 |
|---|---|
| MultinetGetConnectionPerformance | ネットワーク リソースへの接続の予想されるパフォーマンスに関する情報を返します。 |
| WNetAddConnection | ローカル デバイスをネットワーク リソースに接続します。 (16 ビット バージョンの Windows との互換性のために提供されます)。 |
| WNetAddConnection2 | ローカル デバイスをネットワーク リソースに接続します。 |
| WNetAddConnection3 | ローカル デバイスをネットワーク リソースに接続します。 この関数には 、WNetAddConnection2 関数よりも 1 つ多くのパラメーターが含まれています。これは、ネットワーク プロバイダーがダイアログ ボックスの所有者ウィンドウとして使用できるウィンドウへのハンドルです。 |
| WNetCancelConnection | ネットワーク接続を取り消します。 (16 ビット バージョンの Windows との互換性のために提供されます)。 |
| WNetCancelConnection2 | ネットワーク接続を取り消し、永続的な接続に関する情報を使用してユーザー プロファイルを更新する機能を提供します。 |
| WNetConnectionDialog | ネットワーク リソースに接続するための一般的な参照ダイアログ ボックスを開始します。 |
| WNetConnectionDialog1 | CONNECTDLGSTRUCT 構造体を使用して、ネットワーク リソースに接続するための一般的な参照ダイアログ ボックスを開始します。 |
| WNetDisconnectDialog | ネットワーク リソースから切断するための一般的な参照ダイアログ ボックスを開始します。 |
| WNetDisconnectDialog1 | DISCDLGSTRUCT 構造体を使用して、ネットワーク リソースから切断するための一般的な参照ダイアログ ボックスを開始します。 |
| WNetGetConnection | ローカル デバイスに関連付けられているネットワーク リソースの名前を取得します。 |
| WNetGetUniversalName | ネットワーク リソースのドライブ ベースのパスが指定されると、より汎用的な形式の名前が返されます。 |
| WNetRestoreConnectionW | ネットワーク リソースへの接続を復元し、必要に応じて名前とパスワードをユーザーに求めます。 |
| WNetUseConnection | ローカル デバイスをネットワーク リソースに接続します。は、使用されていないローカル デバイスを自動的に選択して、ネットワーク リソースにリダイレクトします。 |
注意
WNetAddConnection 関数と WNetCancelConnection 関数は、Windows for Workgroups との互換性のためにサポートされています。 ただし、新しいアプリケーションでは 、WNetAddConnection2 または WNetAddConnection3 と WNetCancelConnection2 を使用する必要があります。
列挙関数
ネットワーク リソースを列挙するには、次の WNet 関数を呼び出します。
| 機能 | 説明 |
|---|---|
| WNetCloseEnum | ネットワーク リソース列挙を終了します。 |
| WNetEnumResource | WNetOpenEnum 関数によって開始されたネットワーク リソースの列挙を続行します。 |
| WNetOpenEnum | ネットワーク リソースの列挙を開始します。 |
情報関数
ネットワーク プロバイダーやその他の情報を取得するには、次の WNet 情報およびユーティリティ関数を呼び出します。
| 機能 | 説明 |
|---|---|
| WNetGetLastError | WNet 関数によって設定された最新のエラー コード (ネットワーク プロバイダーによって報告されたエラー コード) を返します。 |
| WNetGetNetworkInformation | 特定のネットワーク プロバイダーに関する拡張情報を返します。 |
| WNetGetProviderName | 特定の種類のネットワークのプロバイダー名を返します。 |
| WNetGetResourceInformation | リソースを所有するネットワーク プロバイダーを返し、リソースの種類に関する情報を取得します。 |
| WNetGetResourceParent | ネットワーク リソースの親を返します。 |
ユーザー関数
次の WNet 関数を呼び出して、ローカル デバイスに関連付けられているユーザーの名前を取得します。
| 機能 | 説明 |
|---|---|
| WNetGetUser | 現在の既定のユーザー名、または接続を確立したユーザー名を返します。 |
WNet 関数の多くは、ネットワーク リソースに関する情報を格納するために NETRESOURCE 構造体を使用します。