IActiveDesktop::GetDesktopItem 메서드(shlobj_core.h)
지정된 데스크톱 항목을 가져옵니다.
구문
HRESULT GetDesktopItem(
int nComponent,
[in, out] LPCOMPONENT pcomp,
DWORD dwReserved
);
매개 변수
nComponent
형식: int
데스크톱 항목의 인덱스를 포함하는 부호 없는 긴 정수 값입니다. 인덱스 값은 0부터 시작합니다. IActiveDesktop::GetDesktopItemCount를 사용하여 총 데스크톱 항목 수에 대한 개수를 검색합니다.
[in, out] pcomp
형식: LPCOMPONENT
검색된 데스크톱 항목의 COMPONENT 구조 주소입니다.
dwReserved
형식:DWORD
예약되어 있습니다. 0으로 설정해야 합니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
데스크톱 항목이 활성 데스크톱에서 추가되고 제거되면 인덱스 값이 변경됩니다. 애플리케이션은 인덱스 값이 항상 특정 데스크톱 항목과 연결된다고 가정할 수 없습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | shlobj_core.h |
DLL | Shell32.dll(버전 4.71 이상) |