SHRunControlPanel 함수(shlobj.h)

제어판 항목을 엽니다.

참고 이 함수는 Windows Vista를 기준으로 지원되지 않습니다.

 

구문

BOOL SHRunControlPanel(
  [in]           PCWSTR lpcszCmdLine,
  [in, optional] HWND   hwndMsgParent
);

매개 변수

[in] lpcszCmdLine

형식: PCWSTR

제어판 항목을 여는 명령줄이 포함된 문자열에 대한 포인터입니다. 이 명령줄에는 .cpl 파일의 이름 이상이 포함되어 있습니다. 또한 항목 내의 속성 시트 페이지(서수 또는 이름별)와 같은 기타 필요한 정보를 포함할 수도 있습니다. 자세한 내용은 제어판 항목 실행을 참조하세요.

[in, optional] hwndMsgParent

형식: HWND

항목 열기에 대한 오류 메시지를 표시하는 데 사용되는 부모 창의 핸들입니다. 이 값은 NULL일 수 있습니다.

반환 값

형식: BOOL

true이면 제어판 항목이 성공적으로 열렸고, 그렇지 않으면 FALSE입니다.

Windows Vista를 기준으로 이 함수는 항상 FALSE를 반환 합니다.

설명

지정된 제어판 항목이 이미 실행 중인 경우 SHRunControlPanel은 새 instance 열지 않고 해당 instance 전환하려고 시도합니다.

예제

SHRunControlPanel에 대한 예제 호출은 다음과 같습니다.

SHRunControlPanel(TEXT("timedate.cpl"), hwnd);
SHRunControlPanel(L"appwiz.cpl", NULL);
SHRunControlPanel(L"appwiz.cpl,2", NULL);
SHRunControlPanel("desk.cpl,Settings", hwnd

요구 사항

지원되는 최소 클라이언트	SP1이 설치된 Windows XP[데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj.h
DLL	Shell32.dll