다음을 통해 공유


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

데스크톱 항목을 수정합니다.

구문

HRESULT ModifyDesktopItem(
  [in, out] LPCCOMPONENT pcomp,
            DWORD        dwFlags
);

매개 변수

[in, out] pcomp

형식: LPCCOMPONENT

수정 내용이 포함된 COMPONENT 구조체의 주소입니다. 구조체의 wszSource 멤버와 연결된 데스크톱 항목이 수정됩니다.

dwFlags

형식:DWORD

수정에 사용되는 플래그를 포함하는 부호 없는 long 정수 값입니다. 다음 값 중 하나일 수 있습니다.

COMP_ELEM_ALL

COMP_ELEM_CHECKED

COMP_ELEM_CURITEMSTATE

COMP_ELEM_FRIENDLYNAME

COMP_ELEM_NOSCROLL

COMP_ELEM_ORIGINAL_CSI

COMP_ELEM_POS_LEFT

COMP_ELEM_POS_TOP

COMP_ELEM_POS_ZINDEX

COMP_ELEM_RESTORED_CSI

COMP_ELEM_SIZE_HEIGHT

COMP_ELEM_SIZE_WIDTH

COMP_ELEM_SOURCE

COMP_ELEM_TYPE

반환 값

형식: HRESULT

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

설명

클라이언트 애플리케이션은 레지스트리를 업데이트하려면 IActiveDesktop::ApplyChanges 를 별도로 호출해야 합니다. 예를 들어 이름을 변경하려면 먼저 COMPONENTdwFlags 멤버에서 COMP_ELEM_FRIENDLYNAME 또는 COMP_ELEM_ALL 사용하여 이 함수를 호출합니다. 그런 다음 IActiveDesktop::ApplyChanges를 호출합니다.

요구 사항

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

추가 정보

IActiveDesktop