NetStatisticsGet 함수(lmstats.h)

아티클
03/05/2024

서비스에 대한 운영 통계를 검색합니다. 현재는 워크스테이션 및 서버 서비스만 지원됩니다.

구문

NET_API_STATUS NET_API_FUNCTION NetStatisticsGet(
  [in]  LPTSTR ServerName,
  [in]  LPTSTR Service,
  [in]  DWORD  Level,
  [in]  DWORD  Options,
  [out] LPBYTE *Buffer
);

매개 변수

[in] ServerName

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

[in] Service

통계를 가져올 서비스의 이름을 지정하는 문자열에 대한 포인터입니다. 현재 SERVICE_SERVER 및 SERVICE_WORKSTATION 값만 허용됩니다.

[in] Level

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

값	의미
0	워크스테이션 또는 서버에 대한 통계를 반환합니다. bufptr 매개 변수는 STAT_WORKSTATION_0 또는 STAT_SERVER_0 구조를 가리킵니다.

[in] Options

이 매개 변수는 0이어야 합니다.

[out] Buffer

데이터를 수신하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 수준 매개 변수의 값에 따라 달라집니다. 이 버퍼는 시스템에서 할당되며 NetApiBufferFree 함수를 사용하여 해제해야 합니다. 자세한 내용은 네트워크 관리 함수 버퍼 및 네트워크 관리 함수 버퍼 길이를 참조하세요.

반환 값

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

함수가 실패하면 반환 값은 시스템 오류 코드입니다. 오류 코드 목록은 시스템 오류 코드를 참조하세요.

설명

워크스테이션 통계를 얻기 위해 특별한 그룹 멤버 자격이 필요하지 않습니다. 관리자 또는 서버 연산자 로컬 그룹의 멤버만 원격 서버에서 NetStatisticsGet 함수를 성공적으로 실행할 수 있습니다.

요구 사항

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