CONNECTDLGSTRUCTA 構造体 (winnetwk.h)
CONNECTDLGSTRUCT 構造体は、WNetConnectionDialog1 関数によって参照ダイアログ ボックスパラメーターを確立するために使用されます。
構文
typedef struct _CONNECTDLGSTRUCTA {
DWORD cbStructure;
HWND hwndOwner;
LPNETRESOURCEA lpConnRes;
DWORD dwFlags;
DWORD dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;
メンバーズ
cbStructure
型: DWORD
CONNECTDLGSTRUCT 構造体のサイズ (バイト単位)。 呼び出し元はこの値を指定する必要があります。
hwndOwner
型: HWND
ダイアログ ボックスの所有者ウィンドウへのハンドル。
lpConnRes
型: LPNETRESOURCE
NETRESOURCE 構造体へのポインター。
NETRESOURCE の lpRemoteName メンバーが指定されている場合は、ダイアログ ボックスのパス フィールドに入力されます。
システムは、印刷リソースを参照および接続するための RESOURCETYPE_PRINT フラグをサポートしていません。
dwFlags
型: DWORD
ダイアログ ボックス表示のオプションを記述するビット フラグのセット。 このメンバーは、次の値の組み合わせにすることができます。
| 価値 | 意味 |
|---|---|
|
アカウントはユーザー アカウントです。 |
|
ユーザーがパスを入力できるようにするのではなく、読み取り専用パスを表示します。
このフラグは、lpConnRes メンバーが |
|
内部フラグ。 使用しないでください。 |
|
最後に使用したパスを組み合わせボックスに入力します。 WNetConnectionDialog 関数をシミュレートするには、この値を設定します。 |
|
ユーザーがログオン時に接続を復元できるようにするチェック ボックスを表示します。 |
|
ログオン時に接続を復元します。 |
|
ログオン時に接続を復元しないでください。 |
詳細については、次の「解説」セクションを参照してください。
dwDevNum
型: DWORD
WNetConnectionDialog1 関数の呼び出しが成功した場合、このメンバーは接続されているデバイスの数を返します。 値は、A:の場合は 1、B:の場合は 2、C: の場合は 3 です。 ユーザーがデバイスレス接続を確立した場合、値は –1 です。
備考
CONNDLG_RO_PATHもCONNDLG_USE_MRUフラグも設定されておらず、NETRESOURCE 構造体の lpRemoteName メンバーがリモート・パスを指定しない場合、要求はデフォルトで CONNDLG_RO_PATH ダイアログ表示タイプになります。
CONNDLG_PERSIST値とCONNDLG_NOT_PERSIST値の両方を設定することはできません。 どちらも設定されていない場合、ダイアログ ボックスは、特定の種類のデバイス接続に対してこのダイアログ ボックスで選択された最後のオプションに既定で設定されます。
手記
winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CONNECTDLGSTRUCT を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー | winnetwk.h |
関連項目
NETRESOURCE の
WNetConnectionDialog1 の