MgmGroupEnumerationGetNext 함수(mgm.h)

  • 아티클

MgmGroupEnumerationGetNext 함수는 다음 그룹 항목 집합을 검색합니다. 이 함수에서 반환되는 정보는 조인된 그룹 목록과 요청된 원본(있는 경우)입니다.

그룹은 특정 순서로 반환되지 않습니다.

구문

DWORD MgmGroupEnumerationGetNext(
  [in]      HANDLE hEnum,
  [in, out] PDWORD pdwBufferSize,
  [in, out] PBYTE  pbBuffer,
  [in, out] PDWORD pdwNumEntries
);

매개 변수

[in] hEnum

MgmGroupEnumerationStart에 대한 이전 호출에서 가져온 열거형에 대한 핸들입니다.

[in, out] pdwBufferSize

입력 시 pdwBufferSize는 pbBuffer가 가리키는 버퍼의 크기(바이트)를 포함하는 DWORD 크기의 메모리 위치에 대한 포인터입니다.

출력에서 반환 값이 ERROR_INSUFFICIENT_BUFFER pdwBufferSize 는 pbBuffer 가 가리키는 버퍼가 그룹 항목을 보유해야 하는 최소 크기를 받습니다. 그렇지 않으면 pdwBufferSize 값이 변경되지 않은 상태로 유지됩니다.

[in, out] pbBuffer

입력 시 클라이언트는 버퍼에 대한 포인터를 제공해야 합니다.

출력에서 pbBuffer 에는 하나 이상의 그룹 항목이 포함됩니다. 각 그룹 항목은 SOURCE_GROUP_ENTRY 구조입니다.

[in, out] pdwNumEntries

입력 시 클라이언트는 DWORD 값에 대한 포인터를 제공해야 합니다.

출력에서 pdwNumEntries 는 pbBuffer의 그룹 수를 받습니다.

반환 값

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

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

값 의미
ERROR_CAN_NOT_COMPLETE
 이 함수에 대한 호출을 완료할 수 없습니다.
ERROR_INSUFFICIENT_BUFFER
 지정된 버퍼가 너무 작아서 하나의 그룹도 보유할 수 없습니다. 클라이언트는 하나의 그룹을 검색하는 데 필요한 최소 버퍼 크기에 대해 pdwBufferSize 값을 검사 합니다.
ERROR_INVALID_PARAMETER
 열거형에 대한 핸들이 잘못되었습니다.
ERROR_MORE_DATA
 더 많은 그룹을 사용할 수 있습니다.
ERROR_NO_MORE_ITEMS
 더 이상 그룹을 사용할 수 없습니다. 0개 이상의 그룹이 반환되었습니다. pdwNumEntries 값을 검사 반환된 그룹 수를 확인합니다.
ERROR_NOT_ENOUGH_MEMORY
 메모리가 부족하여 이 작업을 완료할 수 없습니다.
 
 

요구 사항

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

참고 항목

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY