IResultData::InsertItem 메서드(mmc.h)
IResultData::InsertItem 메서드를 사용하면 스냅인에서 결과 창 보기에 단일 새 항목을 추가할 수 있습니다.
구문
HRESULT InsertItem(
[in, out] LPRESULTDATAITEM item
);
매개 변수
[in, out] item
추가할 항목에 대한 정보를 포함하는 RESULTDATAITEM 구조체에 대한 포인터입니다.
항목이 삽입되면 MMC에서 고유 식별자(항목 ID)를 할당하고 항목 매개 변수가 가리키는 구조체의 itemID 멤버를 통해 반환됩니다. itemID 값은 삽입된 항목의 HRESULTITEM 핸들입니다. 스냅인은 나중에 IResultData::GetItem과 같은 메서드를 호출하여 삽입된 항목을 조작하기 위해 이 값을 저장해야 합니다.
이 식별자가 저장되지 않은 경우 IResultData::FindItemByLParam을 사용하여 조회할 수 있습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
설명
RESULTDATAITEM 구조체의 마스크와 관련된 모든 필드를 채워야 합니다. 하위 항목은 삽입할 수 없지만 설정할 수 있습니다. 따라서 항목 구조의 nCol 멤버는 0이어야 합니다.
RESULTDATAITEM의 str 멤버는 MMC_CALLBACK 설정해야 합니다.
항목이 삽입되면 MMC에서 고유 식별자(항목 ID)를 할당하고 항목 매개 변수가 가리키는 구조체의 itemID 멤버를 통해 반환됩니다. itemID 값은 삽입된 항목의 HRESULTITEM 핸들입니다. 스냅인은 나중에 IResultData::GetItem과 같은 메서드를 호출하여 삽입된 항목을 조작하기 위해 이 값을 저장해야 합니다.
이 식별자가 저장되지 않은 경우 IResultData::FindItemByLParam을 사용하여 식별할 수 있습니다.
이 메서드는 가상 목록을 지원하지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |
| DLL | Mmcndmgr.dll |