IActiveDesktop::AddDesktopItem 메서드(shlobj_core.h)

데스크톱 항목을 추가합니다.

구문

HRESULT AddDesktopItem(
  [in] LPCCOMPONENT pcomp,
       DWORD        dwReserved
);

[in] pcomp

형식: LPCCOMPONENT

추가할 항목을 지정하는 COMPONENT 구조체에 대한 포인터입니다.

dwReserved

형식:DWORD

예약되어 있습니다. 0으로 설정해야 합니다.

형식: HRESULT

다음 값 중 하나를 반환합니다.

반환 코드	설명
E_FAIL	데스크톱 항목을 추가하지 못했거나 데스크톱 항목의 instance 이미 활성 데스크톱에 있습니다.
E_INVAILDARG	하나 이상의 매개 변수가 잘못되었습니다.
S_OK	데스크톱 항목이 성공적으로 추가되었습니다.

데스크톱 항목이 데스크톱에 추가되지만 레지스트리에 저장되지는 않습니다. 클라이언트 애플리케이션은 레지스트리를 업데이트하려면 IActiveDesktop::ApplyChanges 를 별도로 호출해야 합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj_core.h
DLL	Shell32.dll(버전 4.71 이상)