CPLINFO 구조체(cpl.h)

제어판 애플리케이션에서 지원하는 대화 상자에 대한 리소스 정보 및 애플리케이션 정의 값을 포함합니다. 제어판 애플리케이션의 CPlApplet 함수는 CPL_INQUIRE 메시지에 대한 응답으로 이 정보를 제어판 반환합니다.

구문

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

멤버

idIcon

형식: int

대화 상자를 나타내는 아이콘의 리소스 식별자입니다.

idName

형식: int

대화 상자의 짧은 이름을 포함하는 문자열의 리소스 식별자입니다. 이 이름은 아이콘 아래에 표시되도록 되어 있습니다.

idInfo

형식: int

애플리케이션 아이콘을 선택할 때 표시할 대화 상자에 대한 설명이 포함된 문자열의 리소스 식별자입니다.

lData

형식: LONG_PTR

애플리케이션에서 정의한 데이터에 대한 포인터입니다. 제어판 CPL_DBLCLK 보내고 메시지를 CPL_STOP 이 값을 애플리케이션에 다시 전달합니다.

설명

대화 상자의 아이콘 또는 표시 문자열이 컴퓨터 상태에 따라 변경되는 경우 유효한 리소스 식별자를 지정하는 대신 idIcon, idName 또는 idInfo 멤버에 대한 CPL_DYNAMIC_RES 값을 지정할 수 있습니다. 이로 인해 제어판 아이콘 및 표시 문자열이 필요할 때마다 CPL_NEWINQUIRE 메시지를 보냅니다. 그러나 제어판 CPL_NEWINQUIRE 메시지를 보낼 때마다 애플리케이션을 로드해야 하기 때문에 이 기술을 사용하는 것이 훨씬 느립니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	cpl.h