WNetEnumResourceA 함수(winnetwk.h)

아티클
11/20/2024

WNetEnumResource 함수는 WNetOpenEnum 함수에 대한 호출로 시작된 네트워크 리소스의 열거를 계속합니다.

통사론

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

매개 변수

[in] hEnum

열거형 인스턴스를 식별하는 핸들입니다. 이 핸들은 WNetOpenEnum 함수에서 반환해야 합니다.

[in, out] lpcCount

요청된 항목 수를 지정하는 변수에 대한 포인터입니다. 요청된 숫자가 –1이면 함수는 가능한 한 많은 항목을 반환합니다.

함수가 성공하면 반환 시 이 매개 변수가 가리키는 변수에 실제로 읽은 항목 수가 포함됩니다.

[out] lpBuffer

열거형 결과를 받는 버퍼에 대한 포인터입니다. 결과는 NETRESOURCE 구조의 배열로 반환됩니다. 할당하는 버퍼는 구조체와 멤버가 가리키는 문자열을 포함할 수 있을 만큼 커야 합니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

버퍼는 hEnum 매개 변수로 지정된 핸들을 사용하여 다음 호출까지 유효합니다. 배열에서 NETRESOURCE 구조체의 순서는 예측할 수 없습니다.

[in, out] lpBufferSize

lpBuffer 매개 변수의 크기를 바이트 단위로 지정하는 변수에 대한 포인터입니다. 버퍼가 너무 작아 하나의 항목도 수신할 수 없는 경우 이 매개 변수는 버퍼의 필요한 크기를 받습니다.

반환 값

함수가 성공하면 반환 값은 다음 값 중 하나입니다.

반환 코드	묘사
NO_ERROR	열거형이 성공했고 버퍼에 요청된 데이터가 포함됩니다. 호출하는 애플리케이션은 계속해서 WNetEnumResource 호출하여 열거를 완료할 수 있습니다.
ERROR_NO_MORE_ITEMS	더 이상 항목이 없습니다. 버퍼 내용이 정의되지 않았습니다.

함수가 실패하면 반환 값은 다음 값 중 하나와 같이시스템 오류 코드입니다.

반환 코드	묘사
ERROR_MORE_DATA	후속 호출을 통해 더 많은 항목을 사용할 수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.
ERROR_INVALID_HANDLE	hEnum 매개 변수에 지정된 핸들이 잘못되었습니다.
ERROR_NO_NETWORK	네트워크를 사용할 수 없습니다. (이 조건은 hEnum 유효성을 테스트하기 전에 테스트됩니다.)
ERROR_EXTENDED_ERROR	네트워크 관련 오류가 발생했습니다. 오류에 대한 설명을 얻으려면 WNetGetLastError 함수를 호출합니다.

발언

WNetEnumResource 함수는 공유에 연결된 사용자를 열거하지 않습니다. 이 작업을 수행하려면 NetConnectionEnum 함수를 호출할 수 있습니다. 숨겨진 공유를 열거하려면 NetShareEnum 함수를 호출합니다.

애플리케이션은 lpBuffer 매개 변수를 NULL 설정하고 lpBufferSize 매개 변수에서 필요한 버퍼 크기를 검색할 수 없습니다. 대신 애플리케이션은 적절한 크기의 버퍼(16킬로바이트)를 할당하고 오류 검색에 lpBufferSize 값을 사용해야 합니다.

예제

네트워크의 모든 리소스를 열거하는 애플리케이션 정의 함수를 보여 주는 코드 샘플은 네트워크 리소스열거하는 참조하세요.

메모

winnetwk.h 헤더는 WNetEnumResource를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winnetwk.h
라이브러리	Mpr.lib
DLL	Mpr.dll