NPEnumResource 함수(npapi.h)

  • 아티클

NPOpenEnum에서 반환된 핸들을 기반으로 열거형을 수행합니다.

구문

DWORD NPEnumResource(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

매개 변수

[in] hEnum

NPOpenEnum 호출에서 가져온 핸들입니다.

[in, out] lpcCount

요청된 항목 수에 대한 포인터입니다. 가능한 한 많은 항목을 요청하는 것이 0xFFFFFFFF 수 있습니다. 호출이 성공하면 이 위치는 실제로 읽은 항목 수를 받게 됩니다.

[out] lpBuffer

NETRESOURCE 항목의 배열로 반환되는 열거형 결과를 받을 버퍼에 대한 포인터입니다. 버퍼는 hEnum을 사용하여 다음 호출까지 유효합니다.

[in, out] lpBufferSize

항목에서 함수 호출에 전달된 버퍼의 크기(바이트)에 대한 포인터입니다. 버퍼가 하나의 항목에 비해 너무 작으면 종료할 때 하나의 항목을 읽는 데 필요한 바이트 수가 포함되어야 합니다. 이 값은 반환 코드가 WN_MORE_DATA 경우에만 설정됩니다.

반환 값

함수가 성공하면 WN_SUCCESS 반환해야 합니다. 호출자는 NPEnumResource 를 계속 호출하여 열거형을 계속할 수 있습니다. 그렇지 않으면 다음 오류 코드 중 하나를 반환해야 합니다.

반환 코드 설명
WN_NO_MORE_ENTRIES
 더 이상 항목이 없습니다. 열거형이 성공적으로 완료되었습니다. 이 경우 반환 버퍼 lpBuffer의 내용이 정의되지 않습니다.
WN_MORE_DATA
 버퍼가 너무 작아서 단일 항목도 보유할 수 없습니다.
WN_BAD_HANDLE
 hEnum 이 유효한 핸들이 아닙니다.
WN_NO_NETWORK
 네트워크가 없습니다. 이 조건은 hEnum 이 유효성을 테스트하기 전에 검사됩니다.

설명

이 함수가 호출되면 공급자는 요청된 항목 수(또는 맞출 수 있는 최대값)로 버퍼를 채워야 합니다. 반환된 NETRESOURCE 구조체는 이러한 구조체의 배열처럼 버퍼의 헤드에 인접하게 배치되어야 합니다. 이러한 구조체의 포인터는 버퍼 내의 위치를 가리킵니다. 따라서 이러한 포인터에서 참조하는 데이터는 구조체 배열 다음에 버퍼의 끝에 있어야 합니다. 이 정보를 올바르게 패키지하는 것은 공급자의 책임입니다.

요구 사항

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