USE_INFO_2 구조체(lmuse.h)
USE_INFO_2 구조에는 연결 유형, 연결 상태, 사용자 이름 및 도메인 이름을 포함하여 로컬 컴퓨터와 공유 리소스 간의 연결에 대한 정보가 포함됩니다.
구문
typedef struct _USE_INFO_2 {
LMSTR ui2_local;
LMSTR ui2_remote;
LMSTR ui2_password;
DWORD ui2_status;
DWORD ui2_asg_type;
DWORD ui2_refcount;
DWORD ui2_usecount;
LMSTR ui2_username;
LMSTR ui2_domainname;
} USE_INFO_2, *PUSE_INFO_2, *LPUSE_INFO_2;
멤버
ui2_local
형식: LMSTR
공유 리소스로 리디렉션되는 로컬 디바이스 이름(예: 드라이브 E 또는 LPT1)이 포함된 문자열에 대한 포인터입니다. 상수 DEVLEN은 문자열의 최대 문자 수를 지정합니다. 이 멤버는 NULL일 수 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.
ui2_remote
형식: LMSTR
원격 리소스의 공유 이름을 포함하는 문자열에 대한 포인터입니다. 문자열이 형식입니다.
\\servername\sharename
_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.
ui2_password
형식: LMSTR
특정 워크스테이션을 사용하여 세션을 설정하는 데 필요한 암호를 포함하는 문자열에 대한 포인터입니다.
_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.
ui2_status
형식:DWORD
연결의 상태. 이 요소는 NetUseAdd 함수에서 사용되지 않습니다. 다음 값이 정의됩니다.
| 값 | 의미 |
|---|---|
|
연결에 성공했습니다. |
|
로컬 워크스테이션에서 일시 중지되었습니다. |
|
연결 끊김 |
|
오류가 발생했습니다. |
|
네트워크 오류가 발생했습니다. |
|
연결이 이루어지고 있습니다. |
|
다시. |
ui2_asg_type
형식:DWORD
액세스되는 원격 리소스의 유형입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
서버의 공유 리소스 유형과 일치합니다. 와일드카드는 NetUseAdd 함수에서만 사용할 수 있으며 ui2_local 멤버가 NULL 문자열인 경우에만 사용할 수 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오. |
|
디스크 디바이스. |
|
스풀 프린터. |
|
IPC(Interprocess Communication). |
ui2_refcount
형식:DWORD
원격 리소스에서 열려 있는 파일, 디렉터리 및 기타 프로세스의 수입니다. 이 요소는 NetUseAdd 함수에서 사용되지 않습니다.
ui2_usecount
형식:DWORD
리소스와 함께 설정된 명시적 연결(로컬 디바이스 이름을 사용한 리디렉션) 또는 암시적 UNC 연결(로컬 디바이스 이름 없는 리디렉션)의 수입니다.
ui2_username
형식: LPWSTR
연결을 시작한 사용자의 이름을 포함하는 문자열에 대한 포인터입니다.
_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.
ui2_domainname
형식: LMSTR
원격 리소스의 도메인 이름을 포함하는 문자열에 대한 포인터입니다.
_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.
설명
NULL인 ui2_local 멤버를 지정하면 드라이브 문자 또는 디바이스를 리디렉션하지 않고 서버로 인증을 요청합니다. 동일한 연결이 적용되는 동안 서버와 관련된 향후 리디렉션은 NetUseAdd 함수에 대한 초기 호출에 지정된 인증 정보를 사용합니다. 이 정보에는 ui2_password, ui2_username 및 ui2_domainname 멤버의 조합 이 포함됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | lmuse.h(Lm.h 포함) |