다음을 통해 공유

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

대화 상자 표시에 대한 옵션을 설명하는 비트 플래그 집합입니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값 의미
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 네트워킹 구조