次の方法で共有

CONNECTDLGSTRUCTW 構造体 (winnetwk.h)

  • [アーティクル]

CONNECTDLGSTRUCT 構造体は、参照ダイアログ ボックスパラメーターを確立するために WNetConnectionDialog1 関数によって使用されます。

構文

typedef struct _CONNECTDLGSTRUCTW {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEW lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTW, *LPCONNECTDLGSTRUCTW;

メンバー

cbStructure

型: DWORD

CONNECTDLGSTRUCT 構造体のサイズ (バイト単位)。 呼び出し元はこの値を指定する必要があります。

hwndOwner

型: HWND

ダイアログ ボックスの所有者ウィンドウへのハンドル。

lpConnRes

種類: LPNETRESOURCE

NETRESOURCE 構造体へのポインター。

NETRESOURCE の lpRemoteName メンバーを指定すると、ダイアログ ボックスの path フィールドに入力されます。 dwType メンバーを除き、NETRESOURCE 構造体の他のすべてのメンバーを NULL に設定する必要があります。 dwType メンバーは、RESOURCETYPE_DISKと等しい必要があります。

システムは、印刷リソースを参照および接続するための RESOURCETYPE_PRINT フラグをサポートしていません。

dwFlags

型: DWORD

ダイアログ ボックス表示のオプションを記述するビット フラグのセット。 このメンバーには、次の値の組み合わせを指定できます。

値 意味
SidTypeUser
 アカウントはユーザー アカウントです。
CONNDLG_RO_PATH
 ユーザーがパスを入力できるようにする代わりに、読み取り専用パスを表示します。

このフラグは、lpConnRes メンバーが指す NETRESOURCE 構造体の lpRemoteName メンバーが NULL (または空の文字列) ではなく、CONNDLG_USE_MRU フラグが設定されていない場合にのみ設定する必要があります。
CONNDLG_CONN_POINT
 内部フラグ。 使用しないでください。
CONNDLG_USE_MRU
 最後に使用したパスを組み合わせボックスに入力します。 WNetConnectionDialog 関数をシミュレートするには、この値を設定します。
CONNDLG_HIDE_BOX
 ユーザーがログオン時に接続を復元できるようにする [チェック] ボックスを表示します。
CONNDLG_PERSIST
 ログオン時に接続を復元します。
CONNDLG_NOT_PERSIST
 ログオン時に接続を復元しないでください。
 

詳細については、「解説」を参照してください。

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 [デスクトップ アプリのみ]
Header winnetwk.h

こちらもご覧ください

NETRESOURCE

WNetConnectionDialog1

Windows ネットワーク (WNet) の概要

Windows ネットワーク構造