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