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