MprConfigInterfaceTransportEnum 함수(mprapi.h)

아티클
08/24/2023

MprConfigInterfaceTransportEnum 함수는 지정된 인터페이스에 구성된 전송을 열거합니다.

구문

DWORD MprConfigInterfaceTransportEnum(
  [in]                HANDLE  hMprConfig,
  [in]                HANDLE  hRouterInterface,
  [in]                DWORD   dwLevel,
  [in, out]           LPBYTE  *lplpBuffer,
  [in]                DWORD   dwPrefMaxLen,
  [out]               LPDWORD lpdwEntriesRead,
  [out]               LPDWORD lpdwTotalEntries,
  [in, out, optional] LPDWORD lpdwResumeHandle
);

매개 변수

[in] hMprConfig

라우터 구성에 대한 핸들입니다. MprConfigServerConnect를 호출하여 이 핸들을 가져옵니다.

[in] hRouterInterface

전송을 열거할 인터페이스 구성에 대한 핸들입니다. MprConfigInterfaceCreate 또는 MprConfigInterfaceEnum을 호출하여 이 핸들을 가져옵니다.

[in] dwLevel

lplpBuffer 매개 변수에서 정보가 반환되는 형식을 설명하는 DWORD 값입니다. 0이어야 합니다.

[in, out] lplpBuffer

입력에서 NULL 이 아닌 포인터입니다.

성공적으로 완료되면 MPR_IFTRANSPORT_0 구조체 배열에 대한 포인터입니다. MprConfigBufferFree를 호출하여 이 메모리 버퍼를 해제합니다.

[in] dwPrefMaxLen

반환된 데이터의 기본 설정 최대 길이(8비트 바이트)를 지정합니다. 이 매개 변수가 -1인 경우 반환되는 버퍼는 사용 가능한 모든 정보를 저장할 수 있을 만큼 큽 있습니다.

[out] lpdwEntriesRead

DWORD 변수에 대한 포인터입니다. 이 변수는 현재 다시 시작 위치에서 열거된 총 항목 수를 받습니다.

[out] lpdwTotalEntries

DWORD 변수에 대한 포인터입니다. 이 변수는 현재 다시 시작 위치에서 열거될 수 있는 총 항목 수를 받습니다.

[in, out, optional] lpdwResumeHandle

DWORD 변수에 대한 포인터입니다.

입력에서 핸들은 첫 번째 호출에서 0이어야 하며 후속 호출에서는 변경되지 않은 상태로 유지됩니다.

출력에서 이 변수는 열거를 계속하는 데 사용되는 다시 시작 핸들을 포함합니다. 핸들이 NULL이면 열거형이 완료됩니다.

열거형에서 오류가 발생하면 이 핸들이 잘못되었습니다.

이 매개 변수는 선택 사항입니다. 호출 애플리케이션이 이 매개 변수에 대해 NULL 을 지정하는 경우 함수는 다시 시작 핸들을 반환하지 않습니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	다음 중 하나에 해당합니다. hMprConfig 는 NULL입니다. HRouterInterface 는 NULL입니다. dwLevel 이 0이 아닙니다. lplpBuffer 가 NULL입니다. dwPrefMaxLen 은 단일 MPR_IFTRANSPORT_0 구조체의 크기보다 작습니다. lpdwEntriesRead 는 NULL입니다. lpdwTotalEntries 가 NULL입니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 완료할 리소스가 부족합니다.
ERROR_NO_MORE_ITEMS	현재 다시 시작 위치에서 사용할 수 있는 항목이 더 이상 없습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

요구 사항


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