SERVER_TRANSPORT_INFO_3 구조체(lmserver.h)

아티클
08/24/2023

SERVER_TRANSPORT_INFO_3 구조에는 이름, 주소 및 암호(자격 증명)를 포함하여 지정된 전송 프로토콜에 대한 정보가 포함됩니다. 이 정보 수준은 NetServerTransportAddEx 함수에만 유효합니다.

구문

typedef struct _SERVER_TRANSPORT_INFO_3 {
  DWORD  svti3_numberofvcs;
  LMSTR  svti3_transportname;
  LPBYTE svti3_transportaddress;
  DWORD  svti3_transportaddresslength;
  LMSTR  svti3_networkaddress;
  LMSTR  svti3_domain;
  ULONG  svti3_flags;
  DWORD  svti3_passwordlength;
  BYTE   svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;

멤버

svti3_numberofvcs

형식:DWORD

svti3_transportname 멤버가 지정한 전송 프로토콜을 사용하는 서버에 연결된 클라이언트 수입니다.

svti3_transportname

형식: LMSTR

전송 디바이스의 이름을 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다. 예를 들어

\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}

_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.

svti3_transportaddress

형식: LPBYTE

서버가 svti3_transportname 멤버가 지정한 전송 디바이스에서 사용 중인 주소를 포함하는 변수에 대한 포인터입니다.

이 멤버는 일반적으로 서버에서 사용 중인 NetBIOS 이름입니다. 이러한 경우 이름은 16자여야 하며 마지막 문자는 빈 문자(0x20)여야 합니다.

svti3_transportaddresslength

형식:DWORD

svti3_transportaddress 멤버의 길이(바이트)입니다. NetBIOS 이름의 경우 이 멤버의 값은 16(10진수)입니다.

svti3_networkaddress

형식: LMSTR

네트워크 어댑터가 사용 중인 주소를 포함하는 NULL로 끝나는 문자 문자열에 대한 포인터입니다. 문자열은 전송에 따라 다릅니다.

NetServerTransportEnum 함수를 호출한 경우에만 이 값을 검색할 수 있습니다. NetServerTransportAdd 함수 또는 NetServerTransportAddEx 함수를 호출하면 이 값을 설정할 수 없습니다.)

_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.

svti3_domain

형식: LMSTR

서버가 현재 상태를 알려야 하는 도메인의 이름을 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다. (NetServerTransportEnum을 호출할 때 이 멤버는 서버가 현재 상태를 발표하는 도메인의 이름입니다.)

_WIN32_WINNT 또는 FORCE_UNICODE 정의된 경우 이 문자열은 유니코드입니다.

svti3_flags

형식: ULONG

이 멤버는 Lmserver.h 헤더 파일에 정의된 다음 비트 값의 조합일 수 있습니다.

값	의미
SVTI2_REMAP_PIPE_NAMES	이 값이 엔드포인트에 대해 설정된 경우 명명된 파이프를 열기 위해 전송을 통해 도착하는 클라이언트 요청은 다음 로컬 파이프 이름으로 다시 라우팅(다시 매핑)됩니다. $$\ServerName\PipeName 이 값의 사용에 대한 자세한 내용은 설명 섹션을 참조하세요.
SVTI2_SCOPED_NAME	이 값이 엔드포인트에 대해 설정되어 있고 동일한 네트워크 주소와 다른 전송 이름 및 SCOPED 플래그에 대한 충돌하는 설정으로 두 번째 전송을 만들려는 시도가 있는 경우 이 전송 만들기가 실패합니다. 따라서 지정된 네트워크 주소에 대해 등록된 모든 전송에는 동일한 범위 설정이 있어야 합니다. 이 값의 사용에 대한 자세한 내용은 설명 섹션을 참조하세요. 이 값은 Windows Server 2008 및 Windows Vista SP1에서 정의됩니다.

값

의미

SVTI2_REMAP_PIPE_NAMES

이 값이 엔드포인트에 대해 설정된 경우 명명된 파이프를 열기 위해 전송을 통해 도착하는 클라이언트 요청은 다음 로컬 파이프 이름으로 다시 라우팅(다시 매핑)됩니다.

$$\ServerName\PipeName

이 값의 사용에 대한 자세한 내용은 설명 섹션을 참조하세요.

SVTI2_SCOPED_NAME

이 값이 엔드포인트에 대해 설정되어 있고 동일한 네트워크 주소와 다른 전송 이름 및 SCOPED 플래그에 대한 충돌하는 설정으로 두 번째 전송을 만들려는 시도가 있는 경우 이 전송 만들기가 실패합니다. 따라서 지정된 네트워크 주소에 대해 등록된 모든 전송에는 동일한 범위 설정이 있어야 합니다.

이 값의 사용에 대한 자세한 내용은 설명 섹션을 참조하세요.

이 값은 Windows Server 2008 및 Windows Vista SP1에서 정의됩니다.

svti3_passwordlength

형식:DWORD

svti3_password 멤버의 유효한 바이트 수입니다.

svti3_password[256]

형식: BYTE[256]

새 전송 주소에 사용할 자격 증명입니다. svti3_passwordlength 멤버가 0이면 서버에 대한 자격 증명이 사용됩니다.

설명

SERVER_TRANSPORT_INFO_3 구조체는 NetServerTransportAddEx 함수에서 지정된 서버를 전송 프로토콜에 바인딩하는 데 사용됩니다.

SVTI2_REMAP_PIPE_NAMES 값의 사용 예는 다음과 같습니다. NetServerTransportAddEx 함수를 호출하여 서버에 전송을 추가하고 svti3_transportaddress 멤버에서 "MyServer"의 주소를 지정하고 svti3_flags 멤버에서 SVTI2_REMAP_PIPE_NAMES. 클라이언트가 "\MyServer"에서 "파이프"를 열려고 하면 클라이언트는 실제로 $$MyServer\Pipe를 엽니다.

클라이언트와 서버가 상호 인증을 수행하려면 svti3_passwordlength 및 svti3_password 멤버가 필요합니다.

Windows Server 2008 및 Windows Vista SP1에서 SRV(Windows 원격 파일 서버)에 등록된 모든 이름은 범위가 지정된 이름 또는 범위가 지정되지 않은 이름으로 지정됩니다. 시스템에 추가된 모든 공유는 범위가 지정되지 않은 모든 이름 또는 단일 범위 이름에 연결됩니다. 범위 지정 기능을 사용하려는 애플리케이션은 새 이름을 범위가 지정된 엔드포인트로 등록한 다음 적절한 scope 사용하여 공유를 만드는 작업을 모두 담당합니다. 이러한 방식으로 네트워크 관리 및 네트워크 공유 관리 함수의 레거시 사용은 범위가 지정되지 않은 이름으로 공유 및 이름을 계속 등록하기 때문에 어떤 식으로든 영향을 받지 않습니다.

범위가 지정된 엔드포인트는 수준 매개 변수가 2로 설정된 NetServerTransportAddEx 함수를 호출하고, bufptr 매개 변수는 svti2_flags 멤버에 설정된 SVTI2_SCOPED_NAME 비트 값이 있는 SERVER_TRANSPORT_INFO_2 구조를 가리켰습니다. 범위가 지정된 엔드포인트는 수준 매개 변수가 3으로 설정된 NetServerTransportAddEx 함수를 호출하고 bufptr 매개 변수가 svti3_flags 멤버에 설정된 SVTI2_SCOPED_NAME 비트 값이 있는 SERVER_TRANSPORT_INFO_3 구조를 가리켰습니다.

전송에 대해 SVTI2_SCOPED_NAME 비트 값을 설정한 경우 NetShareAdd 함수를 사용하여 범위가 지정된 방식으로 해당 서버 이름(SHARE_INFO_503 구조의 shi503_servername 멤버)을 사용하여 공유를 추가할 수 있습니다. SVTI2_SCOPED_NAME 비트 값과 shi503_servername멤버에 제공된 이름으로 등록된 전송이 없으면 범위가 지정된 방식으로 공유 추가가 성공하지 않습니다.

NetShareAdd 함수는 servername 매개 변수에 지정된 원격 서버에서 범위가 지정된 공유를 추가하는 데 사용됩니다. bufptr 매개 변수에 전달된 SHARE_INFO_503 shi503_servername 멤버에 지정된 원격 서버는 NetServerTransportAddEx 함수를 범위가 지정된 엔드포인트로 사용하여 전송 프로토콜에 바인딩되어야 합니다. SVTI2_SCOPED_NAME 플래그는 전송 프로토콜에 대한 SERVER_TRANSPORT_INFO_2 또는 SERVER_TRANSPORT_INFO_3 구조의 shi503_servername 멤버에 지정되어야 합니다. NetShareDelEx 함수는 범위가 지정된 공유를 삭제하는 데 사용됩니다. NetShareGetInfo 및 NetShareSetInfo 함수는 범위가 지정된 공유에 대한 정보를 가져와서 설정하는 데 사용됩니다.

범위가 지정된 엔드포인트는 일반적으로 클러스터 네임스페이스에서 사용됩니다.

요구 사항


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