NetWkstaTransportAdd 함수(lmwksta.h)

  • 아티클

[이 함수는 사용되지 않습니다. 전송 프로토콜에 대한 기본 설정을 수동으로 변경하려면 네트워크 및 전화 접속 연결 폴더의 로컬 영역 연결 속성 대화 상자를 사용합니다.]

지원되지 않습니다.

NetWkstaTransportAdd 함수는 리디렉터를 전송에 바인딩(또는 연결)합니다. 리디렉션자는 서버 컴퓨터에 대한 파일 요청을 생성하는 클라이언트 컴퓨터의 소프트웨어입니다.

구문

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportAdd(
  [in]  LPTSTR  servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

매개 변수

[in] servername

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

이 문자열은 \로 시작해야 합니다.

[in] level

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

값 의미
0
 워크스테이션 전송 프로토콜 정보를 지정합니다. buf 매개 변수는 WKSTA_TRANSPORT_INFO_0 구조를 가리킵니다.

[in] buf

데이터를 지정하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 수준 매개 변수의 값에 따라 달라집니다. 자세한 내용은 네트워크 관리 함수 버퍼를 참조하세요.

[out] parm_err

ERROR_INVALID_PARAMETER 오류를 일으키는 첫 번째 매개 변수의 인덱스를 수신하는 값에 대한 포인터입니다. 이 매개 변수가 NULL이면 인덱스가 오류로 반환되지 않습니다.

반환 값

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

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

반환 코드 설명
ERROR_ACCESS_DENIED
 사용자는 요청한 정보에 대한 액세스 권한이 없습니다.
ERROR_INVALID_LEVEL
 사용 가능한 데이터 구조 정보의 수준을 나타내는 level 매개 변수가 잘못되었습니다.
ERROR_INVALID_PARAMETER
 함수 매개 변수 중 하나가 잘못되었습니다.

설명

Administrators 로컬 그룹의 멤버만 NetWkstaTransportAdd 함수를 성공적으로 실행할 수 있습니다.

NetWkstaTransportAdd 함수가 ERROR_INVALID_PARAMETER 반환하는 경우 parm_err 매개 변수를 사용하여 잘못된 WKSTA_TRANSPORT_INFO_0 구조체의 멤버를 나타낼 수 있습니다. 다음 표에서는 parm_err 매개 변수에 반환할 수 있는 값과 오류가 발생한 해당 구조체 멤버를 나열합니다.

값 멤버
TRANSPORT_QUALITYOFSERVICE_PARMNUM wkti0_quality_of_service
TRANSPORT_NAME_PARMNUM wkti0_transport_name

요구 사항

   
대상 플랫폼 Windows
헤더 lmwksta.h(Lm.h, Lmwksta.h 포함)
라이브러리 Netapi32.lib
DLL Netapi32.dll