NetAccessEnum 함수(lmaccess.h)

[이 함수는 사용되지 않습니다. 대체 함수 목록은 권한 부여 함수를 참조하세요.]

지원되지 않습니다.

NetAccessEnum 함수는 각 액세스 권한 레코드에 대한 정보를 검색합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

매개 변수

servername

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

BasePath

리소스의 기본 경로 이름을 포함하는 문자열에 대한 포인터입니다. NULL 포인터 또는 NULL 문자열은 기본 경로를 사용할 수 없음을 의미합니다. 경로는 UNC(범용 명명 규칙) 경로 이름으로 지정할 수 있습니다.

Recursive

재귀 검색을 사용하거나 사용하지 않도록 설정하는 플래그를 지정합니다.

이 매개 변수가 0과 같으면 NetAccessEnum 함수는 pszBasePath 매개 변수에 의해 기본 경로로 명명된 리소스와 해당 기본 경로 바로 아래의 리소스에 대한 항목을 반환합니다.

이 매개 변수가 0이 아닌 경우 함수는 리소스 이름의 시작 부분에 pszBasePath 가 있는 모든 ACL(액세스 제어 목록)에 대한 항목을 반환합니다.

level

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

값	의미
0	pbBuffer 매개 변수는 access_info_0 구조를 가리킵니다.
1	pbBuffer 매개 변수는 access_info_1 구조를 가리킵니다.

bufptr

액세스 정보 구조를 수신하는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 sLevel 매개 변수의 값에 따라 달라집니다.

prefmaxlen

pbBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.

entriesread

실제로 열거된 요소 수를 수신하는 부호 없는 짧은 정수에 대한 포인터입니다. 수는 NetAccessEnum 함수가 NERR_Success 또는ERROR_MORE_DATA 반환하는 경우에만 유효합니다.

totalentries

열거될 수 있는 총 항목 수를 수신하는 부호 없는 짧은 정수에 대한 포인터입니다. 수는 NetAccessEnum 함수가 NERR_Success 또는ERROR_MORE_DATA 반환하는 경우에만 유효합니다.

resume_handle

TBD

반환 값

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

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

설명

이 기능을 사용하려면 로컬 보안을 사용하도록 설정된 컴퓨터에서 성공적으로 실행하려면 관리 권한이 필요합니다.

요구 사항

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

추가 정보

권한 부여 함수