SHValidateUNC 함수(shlobj_core.h)

[SHValidateUNC 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

WNetAddConnection3을 호출하여 UNC(유니버설 명명 규칙) 경로의 유효성을 검사합니다. 이 함수를 사용하면 사용자가 시작 메뉴의 실행 대화 상자에서 RNA(원격 네트워크 액세스) UNC 애플리케이션 또는 문서 이름을 입력할 수 있습니다.

구문

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

[in, optional] hwndOwner

형식: HWND

UI를 표시하는 데 사용되는 부모 창의 핸들입니다. 이 값이 필요하지 않은 경우 이 값을 NULL로 설정할 수 있습니다.

[in, out] pszFile

형식: PWSTR

유효성을 검사할 UNC 경로를 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 참고: 이 문자열은 상수 문자열이 아니어야 합니다.

fConnect

형식: UINT

다음 값 중 하나 이상입니다.

드라이브 문자를 연결합니다. 이 플래그가 설정되면 pszFile 의 값이 UNC가 로컬 컴퓨터에 매핑되는 로컬 드라이브로 변경됩니다.

실패 또는 성공 시 UI를 표시하지 않습니다.

디스크 공유가 아닌 인쇄 공유로 유효성을 검사합니다.

Windows Vista 이상. 연결을 영구적으로 만들어야 합니다.

SHValidateUNC에 전달된 플래그가 유효한지 확인하는 데 사용되는 마스크 값입니다.

형식: BOOL

UNC 경로가 있으면 TRUE 를 반환합니다. UNC 경로가 없거나 다른 오류가 발생한 경우 FALSE입니다.