WNetEnumResourceA 함수(winnetwk.h)

아티클
08/27/2023

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

구문

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

매개 변수

[in] hEnum

열거형 instance 식별하는 핸들입니다. 이 핸들은 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 매개 변수에서 필요한 버퍼 크기를 검색할 수 없습니다. 대신 애플리케이션은 적절한 크기의 버퍼를 할당해야 합니다( 16KB는 일반적). 오류 검색을 위해 lpBufferSize 값을 사용합니다.

예제

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

참고

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

요구 사항


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