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 멤버를 지정하면 대화 상자의 경로 필드에 입력됩니다. dwType 멤버를 제외하고 NETRESOURCE 구조체의 다른 모든 멤버를 NULL로 설정해야 합니다. dwType 멤버는 RESOURCETYPE_DISK 같아야 합니다.
시스템은 인쇄 리소스를 검색하고 연결하기 위한 RESOURCETYPE_PRINT 플래그를 지원하지 않습니다.
dwFlags
형식:DWORD
대화 상자 표시에 대한 옵션을 설명하는 비트 플래그 집합입니다. 이 멤버는 다음 값의 조합일 수 있습니다.
값 | 의미 |
---|---|
|
계정은 사용자 계정입니다. |
|
사용자가 경로를 입력할 수 있도록 허용하는 대신 읽기 전용 경로를 표시합니다.
lpConnRes 멤버가 가리키는 NETRESOURCE 구조체의 lpRemoteName 멤버가 NULL(또는 빈 문자열)이 아니고 CONNDLG_USE_MRU 플래그가 설정되지 않은 경우에만 이 플래그를 설정해야 합니다. |
|
내부 플래그입니다. 사용하지 마십시오. |
|
조합 상자에 가장 최근에 사용한 경로를 입력합니다. 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 또는 유니코드 버전을 자동으로 선택하는 별칭으로 CONNECTDLGSTRUCT를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
머리글 | winnetwk.h |