다음을 통해 공유

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 구조체에 대한 포인터입니다.

NETRESOURCElpRemoteName 멤버를 지정하면 대화 상자의 경로 필드에 입력됩니다. 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 또는 유니코드 버전을 자동으로 선택하는 별칭으로 CONNECTDLGSTRUCT를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱만 해당]
헤더 winnetwk.h

참고 항목

NETRESOURCE

WNetConnectionDialog1

WNet(Windows 네트워킹) 개요

windows 네트워킹 구조