CopyIcon 함수(winuser.h)

지정된 아이콘을 다른 모듈에서 현재 모듈로 복사합니다.

구문

HICON CopyIcon(
  [in] HICON hIcon
);

[in] hIcon

형식: HICON

복사할 아이콘에 대한 핸들입니다.

형식: HICON

함수가 성공하면 반환 값은 중복 아이콘에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

CopyIcon 함수를 사용하면 애플리케이션 또는 DLL이 다른 모듈이 소유한 아이콘에 대한 자체 핸들을 가져올 수 있습니다. 다른 모듈이 해제된 경우 애플리케이션 아이콘은 여전히 아이콘을 사용할 수 있습니다.

닫기 전에 애플리케이션은 DestroyIcon 함수를 호출하여 아이콘과 연결된 시스템 리소스를 해제해야 합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-gui-l1-3-0(Windows 10 버전 10.0.10240에 도입됨)