SHARE_INFO_503 구조체(lmshare.h)

아티클
03/14/2023

공유 리소스에 대한 정보를 포함합니다. 서버 이름도 포함된다는 점을 제외하고 SHARE_INFO_502 구조와 동일합니다.

구문

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

멤버

shi503_netname

공유 리소스의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다. NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

shi503_type

공유 유형을 지정하는 값의 조합입니다. NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

다음 값 중 하나를 지정할 수 있습니다. STYPE_MASK 값을 사용하여 이러한 값을 격리할 수 있습니다.

값	의미
STYPE_DISKTREE 0x00000000	디스크 드라이브입니다.
STYPE_PRINTQ 0x00000001	인쇄 큐.
STYPE_DEVICE 0x00000002	통신 디바이스.
STYPE_IPC 0x00000003	IPC(Interprocess Communication).

또한 다음 값 중 하나 또는 둘 다를 지정할 수 있습니다.

값	의미
STYPE_SPECIAL 0x80000000	IPC$(프로세스 간 통신) 또는 서버의 원격 관리(ADMIN$)를 위해 예약된 특수 공유입니다. C$, D$, E$등과 같은 관리 공유를 참조할 수도 있습니다. 자세한 내용은 네트워크 공유 함수를 참조하세요.
STYPE_TEMPORARY 0x40000000	임시 공유입니다.

shi503_remark

공유 리소스에 대한 선택적 주석을 지정하는 유니코드 문자열에 대한 포인터입니다.

shi503_permissions

공유 수준 보안으로 실행되는 서버에 대한 공유 리소스의 권한을 나타내는 DWORD 값을 지정합니다. Windows는 공유 수준 보안을 지원하지 않습니다. 이 멤버는 사용자 수준 보안을 실행하는 서버에서 무시됩니다. 보안 개체에 대한 액세스를 제어하는 방법에 대한 자세한 내용은 Access Control, 권한 및 보안 개체를 참조하세요.

NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

이 멤버는 다음 값 중 한 개일 수 있습니다.

값	의미
ACCESS_READ 0x00000001	리소스에서 데이터를 읽고 기본적으로 리소스를 실행할 수 있는 권한입니다.
ACCESS_WRITE 0x00000002	리소스에 데이터를 쓸 수 있는 권한입니다.
ACCESS_CREATE 0x00000004	리소스의 instance 만들 수 있는 권한(예: 파일) 리소스를 만들 때 리소스에 데이터를 쓸 수 있습니다.
ACCESS_EXEC 0x00000008	리소스를 실행할 수 있는 권한입니다.
ACCESS_DELETE 0x00000010	리소스를 삭제할 수 있는 권한입니다.
ACCESS_ATRIB 0x00000020	리소스의 특성을 수정할 수 있는 권한(예: 파일이 마지막으로 수정된 날짜 및 시간).
ACCESS_PERM 0x00000040	사용자 또는 애플리케이션에 대한 리소스에 할당된 권한(읽기, 쓰기, 만들기, 실행 및 삭제)을 수정할 수 있는 권한입니다.
ACCESS_ALL 0x00008000	리소스를 읽고, 쓰고, 만들고, 실행하고, 삭제하고, 해당 특성 및 권한을 수정할 수 있는 권한입니다.

shi503_max_uses

공유 리소스가 수용할 수 있는 최대 동시 연결 수를 나타내는 DWORD 값을 지정합니다. 이 멤버에 지정된 값이 –1인 경우 연결 수는 무제한입니다.

shi503_current_uses

리소스에 대한 현재 연결 수를 나타내는 DWORD 값을 지정합니다. NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

shi503_path

공유 리소스의 로컬 경로를 포함하는 유니코드 문자열에 대한 포인터입니다. 디스크의 경우 이 멤버는 공유되는 경로입니다. 인쇄 큐의 경우 이 멤버는 공유되는 인쇄 큐의 이름입니다. NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

shi503_passwd

공유의 암호를 지정하는 유니코드 문자열에 대한 포인터입니다(서버가 공유 수준 보안으로 실행되는 경우). 서버가 사용자 수준 보안으로 실행되는 경우 이 멤버는 무시됩니다. Windows는 공유 수준 보안을 지원하지 않습니다.

이 멤버는 종료 null 문자를 포함하여 SHPWLEN+1바이트 이상일 수 없습니다. NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

shi503_servername

공유 리소스가 상주하는 원격 서버의 DNS 또는 NetBIOS 이름을 지정하는 문자열에 대한 포인터입니다. 값 "*"은 구성된 서버 이름이 없음을 나타냅니다.

shi503_reserved

예약; 는 0이어야 합니다. NetShareSetInfo 함수에 대한 호출은 이 멤버를 무시합니다.

shi503_security_descriptor

이 공유와 연결된 SECURITY_DESCRIPTOR 지정합니다.

설명

shi503_servername 멤버에 지정된 원격 서버는 NetServerTransportAddEx 함수를 사용하여 전송 프로토콜에 바인딩되어 있어야 합니다. NetServerTransportAddEx 호출에서 수준 매개 변수에 대해 2 또는 3을 지정해야 하며 전송 프로토콜의 SERVER_TRANSPORT_INFO_2 구조에서 SVTI2_SCOPED_NAME 값을 지정해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	lmshare.h(Lm.h 포함)