NPOpenEnum 함수(npapi.h)

  • 아티클

네트워크 리소스 또는 기존 연결의 열거형을 엽니다. 열거형에 대한 유효한 핸들을 가져오려면 NPOpenEnum 함수를 호출해야 합니다.

구문

DWORD NPOpenEnum(
  [in]  DWORD          dwScope,
  [in]  DWORD          dwType,
  [in]  DWORD          dwUsage,
  [in]  LPNETRESOURCEW lpNetResource,
  [out] LPHANDLE       lphEnum
);

매개 변수

[in] dwScope

열거형의 scope 결정합니다. 다음 중 하나일 수 있습니다.

값 의미
RESOURCE_CONNECTED
 현재 연결된 모든 리소스.
RESOURCE_GLOBALNET
 네트워크의 모든 리소스.
RESOURCE_CONTEXT
 사용자의 현재 및 기본 네트워크 컨텍스트와 연결된 리소스입니다("네트워크 이웃" 보기에 사용됨). 이에 대한 해석은 공급자에게 남습니다.

[in] dwType

관심 있는 리소스의 유형을 지정합니다. 다음 플래그의 조합일 수 있는 비트 마스크입니다.

값 의미
RESOURCETYPE_DISK
 모든 디스크 리소스.
RESOURCETYPE_PRINT
 모든 인쇄 리소스.
RESOURCEUSAGE_ATTACHED
 호출자가 인증되지 않은 경우(네트워크에서 인증 없이 열거를 허용하는 경우에도) 함수가 실패하도록 지정합니다.
 

dwType이 0이거나 RESOURCEUSAGE_ATTACHED 경우 모든 유형의 리소스가 반환됩니다. 공급자가 동일한 수준에서 인쇄 및 디스크 리소스를 구분할 수 있는 기능이 없는 경우 모든 리소스를 반환할 수 있습니다.

[in] dwUsage

관심 있는 리소스의 사용을 지정합니다. 다음 플래그의 조합일 수 있는 비트 마스크입니다.

값 의미
RESOURCEUSAGE_CONNECTABLE
 모든 연결 가능한 리소스
RESOURCEUSAGE_CONTAINER
 모든 컨테이너 리소스
 

비트 마스크는 모든 플래그와 일치하도록 0일 수 있습니다. dwScope가 RESOURCE_GLOBALNET 설정되지 않은 경우 이 매개 변수는 무시될 수 있습니다.

[in] lpNetResource

열거형을 수행할 컨테이너에 대한 포인터입니다. NETRESOURCE는 이전 NPEnumResource 호출을 통해 가져오거나 호출자가 생성했거나 NULL일 수 있습니다. NULL이거나 NETRESOURCE의 lpRemoteName 필드가 NULL인 경우 공급자는 네트워크의 최상위 수준을 열거해야 합니다. 이는 공급자가 NULL의 lpRemoteName을 사용하여 네트워크 리소스를 나타낼 수 없음을 의미합니다. 호출자는 일반적으로 이 매개 변수가 NULL로 설정된 NPOpenEnum을 호출하여 시작한 다음, 반환된 결과를 사용하여 추가 열거형을 수행합니다. 호출 프로그램이 열거할 공급자 및 원격 경로를 정확히 알고 있는 경우 lpProvider 및 lpRemoteName 필드를 입력하여 전달할 자체 NETRESOURCE 구조를 빌드할 수 있습니다. dwScope가 RESOURCE_CONNECTED 또는 RESOURCE_CONTEXT 경우 이 매개 변수는 NULL이 됩니다.

[out] lphEnum

NPEnumResource 함수에서 사용할 수 있는 핸들에 대한 포인터입니다. 핸들 사용을 마쳤으면 NPCloseEnum 함수를 호출하여 핸들을 해제합니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 합니다. 그렇지 않으면 다음 중 하나를 포함할 수 있는 오류 코드를 반환해야 합니다.

반환 코드 설명
WN_NOT_SUPPORTED
 공급자는 요청되는 열거형 유형을 지원하지 않거나 특정 네트워크 리소스를 검색할 수 없습니다.
WN_NOT_CONTAINER
 lpNetResource 는 컨테이너를 가리키지 않습니다.
WN_BAD_VALUE
 잘못된 dwScope, dwUsage 또는 dwType 또는 잘못된 매개 변수 조합이 지정되었습니다.
WN_NO_NETWORK
 네트워크가 없습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 npapi.h