NetUseGetInfo 関数 (lmuse.h)
NetUseGetInfo 関数は、共有リソースへの接続に関する情報を取得します。
WNetGetConnection 関数を使用して、ローカル デバイスに関連付けられているネットワーク リソースの名前を取得することもできます。
構文
NET_API_STATUS NET_API_FUNCTION NetUseGetInfo(
[in] LMSTR UncServerName,
[in] LMSTR UseName,
[in] DWORD LevelFlags,
[out] LPBYTE *bufptr
);
パラメーター
[in] UncServerName
この関数を実行するコンピューターの UNC 名。 これがパラメーターが NULL の場合は、ローカル コンピューターが使用されます。 指定された UncServerName パラメーターがリモート コンピューターの場合、リモート コンピューターは従来のリモート アクセス プロトコル メカニズムを使用してリモート RPC 呼び出しをサポートする必要があります。
_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。
[in] UseName
情報を返す接続の名前を指定する文字列へのポインター。
_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。
[in] LevelFlags
要求されたデータの情報レベル。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
ローカル デバイス名とリモート リソースの共有名を指定します。 BufPtr パラメーターは、USE_INFO_0構造体へのポインターです。 |
|
接続の状態や種類など、ローカル デバイスと共有リソース間の接続に関する情報を指定します。 BufPtr パラメーターは、USE_INFO_1構造体へのポインターです。 |
|
ローカル デバイスと共有リソースの間の接続に関する情報を指定します。 情報には、接続の状態、接続の種類、ユーザー名、ドメイン名が含まれます。 BufPtr パラメーターは、USE_INFO_2構造体へのポインターです。 |
[out] bufptr
データを受信するバッファーへのポインター。 このデータの形式は 、Level パラメーターの値によって異なります。 このバッファーはシステムによって割り当てられ、 NetApiBufferFree 関数を使用して解放する必要があります。 詳細については、「 ネットワーク管理機能バッファー 」および「 ネットワーク管理機能バッファーの長さ」を参照してください。
戻り値
関数が成功した場合、戻り値はNERR_Success。
関数が失敗した場合、戻り値はシステム エラー コードです。 エラー コードの一覧については、「 システム エラー コード」を参照してください。
解説
NetUseGetInfo 関数を呼び出すために、特別なグループ メンバーシップは必要ありません。 ダウンレベル互換性がある場合を除き、リモート サーバーでこの関数を実行することはできません。
ローカル コンピューターとリモート サーバー上のリソース間の現在のすべての接続を一覧表示するには、 NetUseEnum 関数を呼び出します。
この関数は、サーバー メッセージ ブロック (LAN マネージャー ワークステーション) クライアントにのみ適用されます。 NetUseGetInfo 関数は、分散ファイル システム (DFS) 共有をサポートしていません。 別のネットワーク プロバイダー (WebDAV や DFS 共有など) を使用して共有の情報を取得するには、 WNetGetConnection 関数を使用します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | lmuse.h (Include Lm.h) |
| Library | Netapi32.lib |
| [DLL] | Netapi32.dll |