MprInfoBlockAdd 함수(mprapi.h)

아티클
03/15/2023

MprInfoBlockAdd 함수는 새 블록을 추가하여 기존 헤더와 동일한 새 헤더를 만듭니다.

구문

DWORD MprInfoBlockAdd(
  [in]  LPVOID lpHeader,
  [in]  DWORD  dwInfoType,
  [in]  DWORD  dwItemSize,
  [in]  DWORD  dwItemCount,
  [in]  LPBYTE lpItemData,
  [out] LPVOID *lplpNewHeader
);

매개 변수

[in] lpHeader

새 블록을 추가할 헤더에 대한 포인터입니다.

[in] dwInfoType

추가할 블록의 형식을 지정합니다. 사용 가능한 형식은 IPv4, IPv6 또는 IPX 전송에 따라 달라집니다.

Windows Server 2008: dwInfoTYpe에 IP_ROUTE_INFO 포함된 경우 lpItemData는 INTERFACE_ROUTE_INFO 구조를 가리킵니다.

[in] dwItemSize

추가할 블록의 각 항목 크기를 지정합니다.

[in] dwItemCount

새 블록의 데이터로 복사할 dwItemSize 크기의 항목 수를 지정합니다.

[in] lpItemData

새 블록의 데이터에 대한 포인터입니다. 이 버퍼의 크기(바이트)는 dwItemSize 및 dwItemCount 의 제품과 같아야 합니다.

[out] lplpNewHeader

반환 성공 시 새 헤더를 가리키는 포인터 변수에 대한 포인터입니다.

반환 값

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

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

값	Description
ERROR_INVALID_PARAMETER	lpHeader, lplpNewHeader 또는 lpItemData 매개 변수가 NULL이거나 dwInfoType 형식의 블록이 헤더에 이미 있습니다.
기타	호출이 실패한 경우 FormatMessage를 사용하여 반환된 오류 코드에 해당하는 오류 메시지를 검색합니다.

설명

정보 블록을 추가한 후 MprInfoBlockQuerySize를 호출하여 정보 헤더의 새 크기를 가져옵니다.

요구 사항


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