MprInfoBlockAdd 함수(mprapi.h)
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 |
|---|---|
|
lpHeader, lplpNewHeader 또는 lpItemData 매개 변수가 NULL이거나 dwInfoType 형식의 블록이 헤더에 이미 있습니다. |
|
호출이 실패한 경우 FormatMessage를 사용하여 반환된 오류 코드에 해당하는 오류 메시지를 검색합니다. |
설명
정보 블록을 추가한 후 MprInfoBlockQuerySize를 호출하여 정보 헤더의 새 크기를 가져옵니다.
요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mprapi.h |
| 라이브러리 | Mprapi.lib |
| DLL | Mprapi.dll |