MgmGetNextMfe 함수(mgm.h)

  • 아티클

MgmGetNextMfe 함수는 하나 이상의 MFE를 검색합니다. 라우팅 테이블 관리자는 지정된 MFE를 따르는 MFE부터 MFE 검색을 시작합니다. 함수는 0개, 1개 이상의 MFE를 검색할 수 있습니다. 반환되는 MFE 수는 MFE의 크기와 함수가 호출되는 경우 클라이언트에서 제공하는 버퍼의 크기에 따라 달라집니다.

버퍼에 반환된 데이터는 먼저 그룹별로 정렬된 다음 그룹 내의 원본에 의해 정렬됩니다.

구문

DWORD MgmGetNextMfe(
  [in]      PMIB_IPMCAST_MFE pimmStart,
  [in, out] PDWORD           pdwBufferSize,
  [in, out] PBYTE            pbBuffer,
  [in, out] PDWORD           pdwNumEntries
);

매개 변수

[in] pimmStart

MFE 검색을 시작할 위치를 지정하는 MIB_IPMCAST_MFE 구조체에 대한 포인터입니다. MIB_IPMCAST_MFE 구조체의 dwSource 및 dwGroup 멤버는 MFE를 식별합니다. MgmGetFirstMfe 또는 MgmGetNextMfe에 대한 이전 호출에서 반환된 마지막 MFE의 원본 및 그룹을 지정합니다.

[in, out] pdwBufferSize

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

출력에서 반환 값이 ERROR_INSUFFICIENT_BUFFER 경우 pdwBufferSize 는 MFE를 보유해야 하는 최소 크기 pbBuffer 를 받습니다. 그렇지 않으면 pdwBufferSize 값이 변경되지 않은 상태로 유지됩니다.

[in, out] pbBuffer

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

출력에서 pbBuffer 에는 하나 이상의 MFE가 포함됩니다. 각 MFE는 MIB_IPMCAST_MFE 구조체입니다.

[in, out] pdwNumEntries

입력 시 클라이언트는 DWORD 크기의 메모리 위치에 대한 포인터를 제공해야 합니다.

출력에서 pdwNumEntries 는 pbBuffer에 포함된 MFE 수를 받습니다.

반환 값

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

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

값 의미
ERROR_CAN_NOT_COMPLETE
 이 함수에 대한 호출을 완료할 수 없습니다.
ERROR_INSUFFICIENT_BUFFER
 지정된 버퍼가 너무 작아서 MFE가 하나라도 있습니다. 클라이언트는 하나의 MFE를 검색하는 데 필요한 최소 버퍼 크기에 대해 pdwBufferSize 값을 검사 합니다.
ERROR_MORE_DATA
 더 많은 MFE를 사용할 수 있습니다.
ERROR_NO_MORE_ITEMS
 더 이상 MFE를 사용할 수 없습니다. 0개 이상의 MFE가 반환되었습니다. pdwNumEntries 값을 검사 반환된 MFE 수를 확인합니다.

설명

이 함수는 MFE의 순차적 검색을 계속하는 데 사용됩니다. MgmGetFirstMfe 를 사용하여 검색 프로세스를 시작합니다.

일반적으로 MFE를 검색하려면 먼저 MgmGetFirstMfe를 호출합니다. 그런 다음, 반환할 MFE가 더 이상 없을 때까지 MgmGetNextMfe 를 한 번 이상 호출합니다. MgmGetNextMfe에 대한 각 호출은 MgmGetNextMfe(또는 MgmGetFirstMfe에 대한 초기 호출)에 대한 이전 호출에서 반환된 마지막 MFE 후에 시작되어야 합니다. 이를 위해 클라이언트는 이전 호출에서 반환된 버퍼의 마지막 원본 및 그룹을 지정합니다.

참고pbBuffer 가 가리키는 버퍼의 최소 크기가 고정되지 않았습니다. MFE마다 다릅니다. sizeof(MIB_IPMCAST_MFE) 매크로를 사용하여 버퍼에 반환된 각 MFE의 크기를 확인합니다.
 

요구 사항

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

추가 정보

MIB_IPMCAST_MFE

MgmGetFirstMfe

MgmGetMfe