DestroyIcon

DestroyIcon

지정된 아이콘을 파기하고, 아이콘용으로 사용되고 있던 메모리를 해방합니다.

BOOL DestroyIcon(
    HICON hIcon  // 아이콘 핸들
);

USER32.DLL

인수

hIcon

파기하는 아이콘의 핸들을 지정합니다.

반환값

함수가 성공하면 0 이외의 값이 돌아갑니다.

함수가 실패하면 0 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

CreateIconIndirect 함수나 CopyIcon 함수등을 사용해 작성된 아이콘이나 마우스 커서는, 불필요하게 되면 DestroyIcon 함수를 사용해 파기하지 않으면 안됩니다.

공유 아이콘을 DestroyIcon 함수로 파기하지 말아 주세요.공유 아이콘은, 아이콘이 로드 된 모듈이 메모리내에 남아 있는 한 유효하게 됩니다.공유 아이콘은 이하의 함수에 의해서 취득됩니다.

• LoadIcon
• LoadImage (LR_SHARED 플래그를 지정했을 경우)
• CopyImage (LR_COPYRETURNORG 플래그를 지정해 있어 hImage 하지만 공유 아이콘의 핸들인 경우)

대응 정보

Windows 95 이후 / Windows NT 3.1 이후