NetWkstaTransportEnum 함수(lmwksta.h)

아티클
08/24/2023

NetWkstaTransportEnum 함수는 서버 컴퓨터에 파일 요청을 생성하는 클라이언트 컴퓨터의 소프트웨어인 리렉터에서 관리하는 전송 프로토콜에 대한 정보를 제공합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetWkstaTransportEnum(
  [in]      LPTSTR  servername,
  [in]      DWORD   level,
  [out]     LPBYTE  *bufptr,
  [in]      DWORD   prefmaxlen,
  [out]     LPDWORD entriesread,
  [out]     LPDWORD totalentries,
  [in, out] LPDWORD resume_handle
);

매개 변수

[in] servername

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

[in] level

데이터에 대해 요청된 정보 수준입니다. 이 매개 변수는 다음 값일 수 있습니다.

값	의미
0	워크스테이션 전송 프로토콜 정보를 반환합니다. bufptr 매개 변수는 WKSTA_TRANSPORT_INFO_0 구조체의 배열을 가리킵니다.

[out] bufptr

데이터를 수신하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 수준 매개 변수의 값에 따라 달라집니다. 이 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수를 사용하여 해제해야 합니다. 함수가 ERROR_MORE_DATA 또는NERR_BufTooSmall 실패하더라도 버퍼를 해제해야 합니다.

[in] prefmaxlen

반환된 데이터의 기본 설정 최대 길이(바이트)입니다. MAX_PREFERRED_LENGTH 지정하는 경우 함수는 데이터에 필요한 메모리 양을 할당합니다. 이 매개 변수에 다른 값을 지정하면 함수가 반환하는 바이트 수를 제한할 수 있습니다. 버퍼 크기가 모든 항목을 보유하기에 충분하지 않은 경우 함수는 ERROR_MORE_DATA 반환하거나 NERR_BufTooSmall. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크 관리 함수 버퍼 길이를 참조하세요.

[out] entriesread

실제로 열거된 요소 수를 수신하는 값에 대한 포인터입니다.

[out] totalentries

현재 다시 시작 위치에서 열거될 수 있는 총 항목 수를 수신하는 값에 대한 포인터입니다. 애플리케이션은 이 값을 힌트로만 고려해야 합니다.

[in, out] resume_handle

기존 워크스테이션 전송 검색을 계속하는 데 사용되는 다시 시작 핸들이 포함된 값에 대한 포인터입니다. 핸들은 첫 번째 호출에서 0이어야 하며 후속 호출의 경우 변경되지 않은 상태로 유지되어야 합니다. resumehandle 매개 변수가 NULL 포인터인 경우 다시 시작 핸들이 저장되지 않습니다.

반환 값

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

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

반환 코드	설명
ERROR_MORE_DATA	더 많은 항목을 사용할 수 있습니다. 모든 항목을 받을 수 있을 만큼 큰 버퍼를 지정합니다.
ERROR_INVALID_LEVEL	사용 가능한 데이터 구조 정보의 수준을 나타내는 level 매개 변수가 잘못되었습니다. 수준 매개 변수가 0이 아닌 값으로 지정된 경우 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	하나 이상의 매개 변수가 잘못되었습니다. 이 오류는 bufptr 또는 entriesread 매개 변수가 NULL 포인터인 경우 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	요청을 처리하는 데 메모리가 부족했습니다.
ERROR_NOT_SUPPORTED	요청이 지원되지 않습니다. 이 오류는 원격 서버가 servername 매개 변수에 지정되어 있고 이 요청이 원격 서버에서 지원되지 않는 경우 반환됩니다.
NERR_BufTooSmall	더 많은 항목을 사용할 수 있습니다. 모든 항목을 받을 수 있을 만큼 큰 버퍼를 지정합니다. 이 오류 코드는 Lmerr.h 헤더 파일에 정의되어 있습니다.

설명

NetWkstaTransportEnum 함수를 성공적으로 실행하려면 특별한 그룹 멤버 자격이 필요하지 않습니다.

요구 사항

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