NetServerTransportAdd 함수(lmserver.h)

NetServerTransportAdd 함수는 서버를 전송 프로토콜에 바인딩합니다.

확장 함수 NetServerTransportAddEx 를 사용하면 호출 애플리케이션이 SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2 및 SERVER_TRANSPORT_INFO_3 정보 수준을 지정할 수 있습니다.

구문

NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

[in] servername

함수를 실행할 원격 서버의 이름을 지정하는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

[in] level

데이터의 정보 수준을 지정합니다. 이 매개 변수는 다음 값일 수 있습니다.

값	의미
0	네트워크의 이름, 주소 및 위치를 포함하여 전송 프로토콜에 대한 정보를 지정합니다. bufptr 매개 변수는 SERVER_TRANSPORT_INFO_0 구조를 가리킵니다.

[in] bufptr

데이터를 포함하는 버퍼에 대한 포인터입니다.

함수가 성공하면 반환 값이 NERR_Success.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_ACCESS_DENIED	사용자는 요청한 정보에 대한 액세스 권한이 없습니다.
ERROR_DUP_NAME	네트워크에 중복된 이름이 있습니다.
ERROR_INVALID_DOMAINNAME	네트워크에서 도메인 이름을 찾을 수 없습니다.
ERROR_INVALID_LEVEL	level 매개 변수에 대해 지정된 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 이 오류는 bufptr 매개 변수가 가리키는 SERVER_TRANSPORT_INFO_0 구조체의 svti0_transportname 또는 svti0_transportaddress 멤버가 NULL인 경우 반환됩니다. 이 오류는 bufptr 매개 변수가 가리키는 SERVER_TRANSPORT_INFO_0 구조체의 svti0_transportaddresslength 멤버가 0이거나 MAX_PATH(Windef.h 헤더 파일에 정의됨)보다 큰 경우에도 반환됩니다. 이 오류는 다른 잘못된 매개 변수에 대해서도 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	사용 가능한 메모리가 부족합니다.

관리자 또는 서버 연산자 로컬 그룹의 멤버만 NetServerTransportAdd 함수를 성공적으로 실행할 수 있습니다.

NetServerTransportAdd 함수 호출을 사용하여 서버에 전송 프로토콜을 추가하는 경우 서버를 다시 부팅하거나 다시 시작한 후에도 연결이 유지되지 않습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	lmserver.h(Lm.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll