NetGetDisplayInformationIndex 함수(lmaccess.h)

NetGetDisplayInformationIndex 함수는 이름이 지정된 문자열로 시작하거나 이름이 문자열을 사전순으로 따르는 첫 번째 표시 정보 항목의 인덱스를 반환합니다. 이 함수를 사용하여 NetQueryDisplayInformation 함수에 대한 후속 호출의 시작 인덱스 를 확인할 수 있습니다.

구문

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

매개 변수

[in] ServerName

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

[in] Level

쿼리할 계정 수준을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
1	모든 로컬 및 전역(일반) 사용자 계정을 쿼리합니다.
2	모든 워크스테이션 및 서버 사용자 계정을 쿼리합니다.
3	모든 전역 그룹을 쿼리합니다.

[in] Prefix

검색할 접두사를 지정하는 문자열에 대한 포인터입니다.

[out] Index

요청된 항목의 인덱스를 받는 값에 대한 포인터입니다.

반환 값

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

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

반환 코드	설명
ERROR_ACCESS_DENIED	사용자는 요청한 정보에 대한 액세스 권한이 없습니다.
ERROR_INVALID_LEVEL	Level 매개 변수에 지정된 값이 잘못되었습니다.
ERROR_NO_MORE_ITEMS	작동할 항목이 더 이상 없었습니다.
NERR_InvalidComputer	컴퓨터 이름이 잘못된 경우

설명

Active Directory를 실행하는 도메인 컨트롤러에서 이 함수를 호출하는 경우 보안 개체에 대한 ACL(액세스 제어 목록)에 따라 액세스가 허용되거나 거부됩니다. 기본 ACL은 "사전 Windows 2000 호환 액세스" 그룹의 모든 인증된 사용자와 멤버가 정보를 볼 수 있도록 허용합니다. 멤버 서버 또는 워크스테이션에서 이 함수를 호출하는 경우 인증된 모든 사용자가 정보를 볼 수 있습니다. 이러한 플랫폼에서 익명 액세스 및 익명 액세스 제한에 대한 자세한 내용은 네트워크 관리 함수에 대한 보안 요구 사항을 참조하세요. ACL, ACL 및 액세스 토큰에 대한 자세한 내용은 Access Control 모델을 참조하세요.

함수는 호출자에게 읽기 권한이 있는 정보만 반환합니다. 호출자는 Domain 개체에 대한 List Contents 액세스 권한이 있어야 하며 시스템 컨테이너에 있는 SAM Server 개체에서 전체 SAM 도메인 액세스를 열거해야 합니다.

요구 사항

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

참고 항목

함수 가져오기

NetQueryDisplayInformation

네트워크 관리 함수

네트워크 관리 개요