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.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
이 함수에 대한 호출을 완료할 수 없습니다. |
|
지정된 버퍼가 너무 작아서 MFE가 하나라도 있습니다. 클라이언트는 하나의 MFE를 검색하는 데 필요한 최소 버퍼 크기에 대해 pdwBufferSize 값을 검사 합니다. |
|
더 많은 MFE를 사용할 수 있습니다. |
|
더 이상 MFE를 사용할 수 없습니다. 0개 이상의 MFE가 반환되었습니다. pdwNumEntries 값을 검사 반환된 MFE 수를 확인합니다. |
설명
이 함수는 MFE의 순차적 검색을 계속하는 데 사용됩니다. MgmGetFirstMfe 를 사용하여 검색 프로세스를 시작합니다.
일반적으로 MFE를 검색하려면 먼저 MgmGetFirstMfe를 호출합니다. 그런 다음, 반환할 MFE가 더 이상 없을 때까지 MgmGetNextMfe 를 한 번 이상 호출합니다. MgmGetNextMfe에 대한 각 호출은 MgmGetNextMfe(또는 MgmGetFirstMfe에 대한 초기 호출)에 대한 이전 호출에서 반환된 마지막 MFE 후에 시작되어야 합니다. 이를 위해 클라이언트는 이전 호출에서 반환된 버퍼의 마지막 원본 및 그룹을 지정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mgm.h |
| 라이브러리 | Rtm.lib |
| DLL | Rtm.dll |