USE_INFO_1 構造体 (lmuse.h)
USE_INFO_1構造体には、ローカル デバイスと共有リソースの間の接続に関する情報が含まれています。 情報には、接続の状態と接続の種類が含まれます。
構文
typedef struct _USE_INFO_1 {
LMSTR ui1_local;
LMSTR ui1_remote;
LMSTR ui1_password;
DWORD ui1_status;
DWORD ui1_asg_type;
DWORD ui1_refcount;
DWORD ui1_usecount;
} USE_INFO_1, *PUSE_INFO_1, *LPUSE_INFO_1;
メンバー
ui1_local
種類: LMSTR
共有リソースにリダイレクトされるローカル デバイス名 (ドライブ E や LPT1 など) を含む文字列へのポインター。 定数 DEVLEN は、文字列内の最大文字数を指定します。 このメンバーは NULL にすることができます。 詳細については、「解説」を参照してください。
_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。
ui1_remote
種類: LMSTR
アクセスするリモート リソースの共有名を含む文字列へのポインター。 文字列は次の形式です。
\\servername\sharename
_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。
ui1_password
種類: LMSTR
特定のワークステーションとサーバー間のセッションを確立するために必要なパスワードを含む文字列へのポインター。
_WIN32_WINNTまたはFORCE_UNICODEが定義されている場合、この文字列は Unicode です。
ui1_status
型: DWORD
接続の状態。 この要素は、 NetUseAdd 関数では使用されません。 次の値が定義されています。
| 値 | 説明 |
|---|---|
|
接続が有効です。 |
|
ローカル ワークステーションで一時停止しました。 |
|
[接続解除されました。] |
|
エラーが発生しました。 |
|
ネットワーク エラーが発生しました。 |
|
接続が確立されています。 |
|
再接続。 |
ui1_asg_type
型: DWORD
アクセスするリモート リソースの種類。 このメンバーには、次のいずれかの値を指定できます。
| 値 | 説明 |
|---|---|
|
サーバーの共有リソースの種類と一致します。 ワイルドカードは NetUseAdd 関数でのみ使用でき、 ui1_local メンバーが NULL の場合にのみ使用できます。 詳細については、「解説」を参照してください。 |
|
ディスク デバイス。 |
|
スプール・プリンター。 |
|
プロセス間通信 (IPC)。 |
ui1_refcount
型: DWORD
リモート リソースで開かれているファイル、ディレクトリ、およびその他のプロセスの数。 この要素は、 NetUseAdd 関数では使用されません。
ui1_usecount
型: DWORD
リソースで確立された明示的な接続 (ローカル デバイス名を使用したリダイレクト) または暗黙的な UNC 接続 (ローカル デバイス名のないリダイレクト) の数。
解説
NULL であるui1_local メンバーを指定すると、ドライブ文字やデバイスをリダイレクトすることなく、サーバーとの認証が要求されます。 同じ接続が有効な間にサーバーに関連する今後のリダイレクトでは、NetUseAdd 関数の最初の呼び出しで、ui1_password メンバーによって指定されたパスワードが使用されます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | lmuse.h (Include Lm.h) |