IShellFolderView::AddObject 메서드(shlobj_core.h)

[AddObject 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

뷰에 항목을 추가합니다.

구문

HRESULT AddObject(
  [in]  PUITEMID_CHILD pidl,
  [out] UINT           *puItem
);

매개 변수

[in] pidl

형식: PUITEMID_CHILD

뷰에 추가할 항목을 지정하는 ItemID에 대한 포인터입니다.

[out] puItem

형식: UINT*

이 메서드가 성공적으로 반환될 때 추가된 항목의 인덱스 위치를 수신하는 값에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

이 인덱스로 IShellFolderView::GetObject 를 즉시 호출하면 추가한 ITEMID_CHILD 복사본이 표시됩니다. 그러나 항목의 인덱스 위치는 시간이 지남에 따라 변경될 수 있으므로 코드는 특정 인덱스가 항상 동일한 ITEMID_CHILD 반환한다는 것을 신뢰할 수 없습니다.

이 메서드를 통해 추가된 항목은 언제든지 데이터 원본에서 뷰에서 제거할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h