CPL_INQUIRE 메시지

애플리케이션이 지원하는 대화 상자에 대한 정보를 요청하기 위해 제어판 애플리케이션의 CPlApplet 함수로 전송됩니다.

매개 변수

uAppNum

대화 상자 번호입니다. 이 숫자는 CPL_GETCOUNT 메시지( CPL_GETCOUNT – 1)에 대한 응답으로 반환된 값보다 0부터 1까지의 범위에 있어야 합니다.

lpcpli

CPLINFO 구조체의 주소입니다. 애플리케이션은 아이콘, 짧은 이름, 설명 및 대화 상자와 연결된 모든 사용자 정의 값에 대한 리소스 식별자를 사용하여 이 구조를 채워야 합니다.

반환 값

CPlApplet 함수가 이 메시지를 성공적으로 처리하면 0을 반환해야 합니다.

설명

제어판 애플리케이션에서 지원하는 각 대화 상자에 대해 CPL_INQUIRE 메시지를 한 번 보냅니다. 또한 제어판 각 대화 상자에 대한 CPL_NEWINQUIRE 메시지를 보냅니다. 이러한 메시지는 CPL_GETCOUNT 메시지 바로 다음에 전송됩니다. 그러나 시스템은 CPL_INQUIRE 및CPL_NEWINQUIRE 메시지가 전송되는 순서를 보장하지 않습니다.

CPL_INQUIRE 받으면 대화 상자에 대한 초기화를 수행할 수 있습니다. 메모리를 할당해야 하는 경우 CPL_INIT 메시지에 대한 응답으로 이 작업을 수행합니다.

CPL_NEWINQUIRE 메시지는 시스템에서 캐시할 수 없는 형태로 정보를 반환합니다. 이러한 이유로 대부분의 CPlApplet 함수는 CPL_INQUIRE 처리하고 CPL_NEWINQUIRE 무시해야 합니다.

CPL_NEWINQUIRE 사용해야 하는 유일한 애플리케이션은 컴퓨터 상태에 따라 아이콘을 변경하거나 문자열을 표시해야 하는 애플리케이션뿐입니다. 이 경우 CPL_INQUIRE 처리기는 유효한 리소스 식별자를 지정하는 대신 CPLINFO 구조체의 idIcon, idName 또는 idInfo 멤버에 대한 CPL_DYNAMIC_RES 값을 지정해야 합니다. 이로 인해 제어판 아이콘과 표시 문자열이 필요할 때마다 CPL_NEWINQUIRE 메시지를 보내 컴퓨터의 현재 상태에 따라 정보를 지정할 수 있습니다. 캐시된 정보를 사용하는 것보다 훨씬 느립니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Cpl.h