Share via


NetServerTransportAdd 함수(lmserver.h)

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

확장 함수 NetServerTransportAddEx 를 사용하면 호출 애플리케이션이 SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2SERVER_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

추가 정보

NetServerComputerNameAdd

NetServerComputerNameDel

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

네트워크 관리 함수

네트워크 관리 개요

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SERVER_TRANSPORT_INFO_3

서버 및 워크스테이션 전송 함수