ホーム › NetworkManagement.WNet › WNetConnectionDialog1W

WNetConnectionDialog1W

関数

構造体を指定して接続ダイアログを表示する(Unicode版)。

DLLMPR.dll文字セットUnicode (-W)呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// MPR.dll  (Unicode / -W)
#include <windows.h>

WIN32_ERROR WNetConnectionDialog1W(
    CONNECTDLGSTRUCTW* lpConnDlgStruct
);

パラメーター

名前	型	方向	説明
lpConnDlgStruct	CONNECTDLGSTRUCTW*	inout	CONNECTDLGSTRUCT 構造体へのポインター。この構造体は、参照ダイアログのパラメーターを設定します。

戻り値の型: WIN32_ERROR

公式ドキュメント

WNetConnectionDialog1 関数は、ネットワークリソースに接続するための汎用の参照ダイアログを表示します。この関数では、ダイアログボックスのパラメーターを設定するために CONNECTDLGSTRUCT が必要です。(Unicode)

戻り値

ユーザーがダイアログボックスをキャンセルした場合、この関数は –1 を返します。関数が成功した場合は NO_ERROR を返します。また、呼び出しが成功した場合、 CONNECTDLGSTRUCT 構造体の dwDevNum メンバーに、接続されたデバイスの番号が格納されます。

通常、このダイアログがエラーを返すのは、ユーザーがダイアログセッションを開始できない場合のみです。これは、ダイアログセッションの開始後に発生したエラーはユーザーに直接報告されるためです。関数が失敗した場合、戻り値は次のいずれかの値などのシステムエラーコードです。

戻り値	説明
ERROR_INVALID_PARAMETER	CONNDLG_RO_PATH と CONNDLG_USE_MRU の両方のダイアログボックスオプションが設定されています。(ダイアログボックスのオプションは、 CONNECTDLGSTRUCT 構造体の dwFlags メンバーで指定します。) -または- CONNDLG_PERSIST と CONNDLG_NOT_PERSIST の両方のダイアログボックスオプションが設定されています。 -または- CONNDLG_RO_PATH ダイアログボックスオプションが設定されているにもかかわらず、NETRESOURCE 構造体の lpRemoteName メンバーがリモートネットワークを指していません。(CONNECTDLGSTRUCT 構造体は NETRESOURCE 構造体を指します。)
ERROR_BAD_DEV_TYPE	NETRESOURCE 構造体の dwType メンバーが RESOURCETYPE_DISK に設定されていません。
ERROR_BUSY	ネットワークプロバイダーがビジー状態です (初期化中の可能性があります)。呼び出し元は再試行してください。
ERROR_NO_NETWORK	ネットワークが利用できません。
ERROR_NOT_ENOUGH_MEMORY	ダイアログボックスを表示するためのメモリが不足しています。
ERROR_EXTENDED_ERROR	ネットワーク固有のエラーが発生しました。 WNetGetLastError を呼び出して、エラーの説明を取得してください。

解説(Remarks)

メモ

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして WNetConnectionDialog1 を定義します。エンコーディングに依存しないエイリアスを、エンコーディングに依存するコードと混在させて使用すると、不一致が生じ、コンパイルエラーや実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// MPR.dll  (Unicode / -W)
#include <windows.h>

WIN32_ERROR WNetConnectionDialog1W(
    CONNECTDLGSTRUCTW* lpConnDlgStruct
);

[DllImport("MPR.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern uint WNetConnectionDialog1W(
    IntPtr lpConnDlgStruct   // CONNECTDLGSTRUCTW* in/out
);

<DllImport("MPR.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function WNetConnectionDialog1W(
    lpConnDlgStruct As IntPtr   ' CONNECTDLGSTRUCTW* in/out
) As UInteger
End Function

' lpConnDlgStruct : CONNECTDLGSTRUCTW* in/out
Declare PtrSafe Function WNetConnectionDialog1W Lib "mpr" ( _
    ByVal lpConnDlgStruct As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WNetConnectionDialog1W = ctypes.windll.mpr.WNetConnectionDialog1W
WNetConnectionDialog1W.restype = wintypes.DWORD
WNetConnectionDialog1W.argtypes = [
    ctypes.c_void_p,  # lpConnDlgStruct : CONNECTDLGSTRUCTW* in/out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MPR.dll')
WNetConnectionDialog1W = Fiddle::Function.new(
  lib['WNetConnectionDialog1W'],
  [
    Fiddle::TYPE_VOIDP,  # lpConnDlgStruct : CONNECTDLGSTRUCTW* in/out
  ],
  -Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"

#[link(name = "mpr")]
extern "system" {
    fn WNetConnectionDialog1W(
        lpConnDlgStruct: *mut CONNECTDLGSTRUCTW  // CONNECTDLGSTRUCTW* in/out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("MPR.dll", CharSet = CharSet.Unicode)]
public static extern uint WNetConnectionDialog1W(IntPtr lpConnDlgStruct);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MPR_WNetConnectionDialog1W' -Namespace Win32 -PassThru
# $api::WNetConnectionDialog1W(lpConnDlgStruct)

#uselib "MPR.dll"
#func global WNetConnectionDialog1W "WNetConnectionDialog1W" wptr
; WNetConnectionDialog1W varptr(lpConnDlgStruct)   ; 戻り値は stat
; lpConnDlgStruct : CONNECTDLGSTRUCTW* in/out -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MPR.dll"
#cfunc global WNetConnectionDialog1W "WNetConnectionDialog1W" var
; res = WNetConnectionDialog1W(lpConnDlgStruct)
; lpConnDlgStruct : CONNECTDLGSTRUCTW* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MPR.dll"
#cfunc global WNetConnectionDialog1W "WNetConnectionDialog1W" sptr
; res = WNetConnectionDialog1W(varptr(lpConnDlgStruct))
; lpConnDlgStruct : CONNECTDLGSTRUCTW* in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。