INameSpaceTreeControl::InsertRoot 메서드(shobjidl_core.h)

트리의 루트 항목에 셸 항목을 삽입합니다.

구문

HRESULT InsertRoot(
  [in]           int              iIndex,
  [in]           IShellItem       *psiRoot,
  [in]           SHCONTF          grfEnumFlags,
  [in]           NSTCROOTSTYLE    grfRootStyle,
  [in, optional] IShellItemFilter *pif
);

매개 변수

[in] iIndex

형식: int

루트를 삽입할 인덱스입니다.

[in] psiRoot

형식: IShellItem*

삽입되는 셸 항목에 대한 포인터입니다.

[in] grfEnumFlags

형식: SHCONTF

루트와 모든 자식의 자질을 열거합니다. SHCONTF 형식의 값 중 하나입니다.

[in] grfRootStyle

형식: NSTCROOTSTYLE

삽입할 루트의 스타일입니다. 다음 값 중 하나 이상(플래그는 비트 OR을 사용하여 결합할 수 있음).

NSTCRS_VISIBLE(0x0000)

루트는 항목뿐만 아니라 표시됩니다. NSTCRS_HIDDEN 함께 사용할 수 없습니다.

NSTCRS_HIDDEN(0x0001)

자식만 표시되도록 루트가 숨겨집니다. NSTCRS_VISIBLE 함께 사용할 수 없습니다.

NSTCRS_EXPANDED(0x0002)

루트는 초기화 시 확장됩니다.

[in, optional] pif

형식: IShellItemFilter*

트리에 표시되는 항목을 필터링할 수 있는 IShellItemFilter 에 대한 포인터입니다. 제공된 경우 SHCONTF 플래그를 사용하여 모든 항목을 사용자 지정할 수 있습니다. 필터가 필요하지 않은 경우 이 값은 NULL 일 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)