MgmGroupEnumerationStart 함수(mgm.h)

  • 아티클

MgmGroupEnumerationStart 함수는 나중에 조인된 그룹 목록을 가져오는 데 사용되는 열거형 핸들을 가져옵니다. 클라이언트가 핸들을 가져온 후에 는 MgmGroupEnumerationGetNext 함수를 사용하여 그룹을 열거해야 합니다.

구문

DWORD MgmGroupEnumerationStart(
  [in]  HANDLE         hProtocol,
  [in]  MGM_ENUM_TYPES metEnumType,
  [out] HANDLE         *phEnumHandle
);

매개 변수

[in] hProtocol

MgmRegisterMProtocol에 대한 이전 호출에서 얻은 프로토콜에 대한 핸들입니다.

[in] metEnumType

열거형의 형식을 지정합니다. 다음 열거형을 사용할 수 있습니다.

열거형 의미
ALL_SOURCES
 와일드카드 조인(*, g) 및 원본별 조인(s, g)을 검색합니다.
ANY_SOURCE
 하나 이상의 원본이 지정된 그룹 항목을 검색합니다.

[out] phEnumHandle

열거형에 대한 핸들을 받습니다. MgmGroupEnumerationGetNext 및 MgmGroupEnumerationEnd에 대한 호출에서 이 핸들을 사용합니다.

반환 값

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

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

값 의미
ERROR_CAN_NOT_COMPLETE
 이 함수에 대한 호출을 완료할 수 없습니다.
ERROR_INVALID_PARAMETER
 프로토콜에 대한 핸들이 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY
 메모리가 부족하여 이 작업을 완료할 수 없습니다.
 
 

요구 사항

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

추가 정보

MGM_ENUM_TYPES

MgmGroupEnumerationEnd

MgmGroupEnumerationGetNext