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 メンバーが指定されている場合は、ダイアログ ボックスの 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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header winnetwk.h

こちらもご覧ください

NETRESOURCE

WNetConnectionDialog1

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

Windows ネットワーク構造