SHEvaluateSystemCommandTemplate 함수(shellapi.h)

CreateProcess 또는 ShellExecute 호출에 사용되는 매개 변수의 엄격한 유효성 검사를 적용합니다.

구문

SHSTDAPI SHEvaluateSystemCommandTemplate(
  [in]            PCWSTR pszCmdTemplate,
  [out]           PWSTR  *ppszApplication,
  [out, optional] PWSTR  *ppszCommandLine,
  [out, optional] PWSTR  *ppszParameters
);

매개 변수

[in] pszCmdTemplate

형식: PCWSTR

매개 변수를 포함하거나 포함하지 않을 수 있는 명령줄입니다. 매개 변수가 대체 매개 변수인 경우 매개 변수를 바꾸기 전에 SHEvaluateSystemCommandTemplate 을 호출해야 합니다.

[out] ppszApplication

형식: PWSTR*

애플리케이션의 확인된 경로에 대한 포인터입니다. 이 값은 CreateProcess 호출에서 lpApplication 매개 변수로 전달되거나 ShellExecute 호출에서 lpFile 매개 변수로 전달되어야 합니다. 이 리소스는 CoTaskMemAlloc을 사용하여 할당되며, CoTaskMemFree를 호출하여 더 이상 필요하지 않을 때 리소스를 해제하는 것은 호출자의 책임입니다.

[out, optional] ppszCommandLine

형식: PWSTR*

CreateProcess 호출에 사용할 명령줄 문자열 템플릿에 대한 포인터입니다. 명령줄 매개 변수는 이 템플릿을 기반으로 지정한 다음, CreateProcess에 lpCommandLine 매개 변수로 전달되어야 합니다. PathGetArgs가 항상 올바르게 읽을 수 있는 형식으로 보장됩니다. 이 리소스는 CoTaskMemAlloc을 사용하여 할당되며, CoTaskMemFree를 호출하여 더 이상 필요하지 않을 때 리소스를 해제하는 것은 호출자의 책임입니다.

이 함수가 CreateProcess 호출과 관련하여 사용되지 않는 경우 이 매개 변수는 NULL일 수 있습니다.

[out, optional] ppszParameters

형식: PWSTR*

ShellExecute 호출에 사용할 명령줄 문자열 템플릿에 대한 포인터입니다. 명령줄 매개 변수는 이 템플릿을 기반으로 지정한 다음 lpParameters 매개 변수로 ShellExecute에 전달되어야 합니다. 이 매개 변수는 PathGetArgs 호출과 동일합니다. 이 리소스는 CoTaskMemAlloc을 사용하여 할당되며, CoTaskMemFree를 호출하여 더 이상 필요하지 않을 때 리소스를 해제하는 것은 호출자의 책임입니다.

이 함수가 CreateProcess 호출과 관련하여 사용되지 않는 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 실행 컨텍스트에 관계없이 호출 프로세스에 명령 템플릿의 결정적 동작이 필요할 때 사용됩니다. , GetCurrentDirectory 및 부모 프로세스 디렉터리와 같은 %PATH%현재 프로세스 상태를 무시합니다.

이 함수는 명령이 하드 코딩된 경우에 사용됩니다.

이 함수는 HKEY_CLASSES_ROOT 파일 연결을 처리할 때 ShellExecute 에서 사용됩니다. 이 함수의 목적은 CreateProcess 명령줄 익스플로잇을 줄이는 것입니다. 사용자 입력을 처리하도록 설계되지 않았으며 해당 용도로 사용되는 경우 예기치 않은 오류가 발생할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shellapi.h
DLL	Shell32.dll
API 세트	ext-ms-win-shell-shell32-l1-2-2(Windows 10 버전 10.0.14393에 도입됨)