CPL_NEWINQUIRE 메시지

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

매개 변수

uAppNum

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

lpncpli

NEWCPLINFO 구조체의 주소입니다. 제어판 애플리케이션은 대화 상자에 대한 정보로 이 구조를 채워야 합니다.

반환 값

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

설명

성능을 향상시키려면 대부분의 애플리케이션은 CPL_NEWINQUIRE 무시하고 대신 CPL_INQUIRE 메시지를 처리해야 합니다.

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

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

CPL_INQUIRE 기본 메시지입니다. CPL_NEWINQUIRE 시스템에서 캐시할 수 없는 형식으로 정보를 반환하기 때문입니다. 따라서 CPL_NEWINQUIRE 처리하는 애플리케이션은 제어판 정보가 필요할 때마다 로드되어야 하므로 성능이 크게 저하됩니다.

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

요구 사항

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