SHELLEXECUTEINFOA 구조체(shellapi.h)

ShellExecuteEx사용하는 정보를 포함합니다.

통사론

typedef struct _SHELLEXECUTEINFOA {
  DWORD     cbSize;
  ULONG     fMask;
  HWND      hwnd;
  LPCSTR    lpVerb;
  LPCSTR    lpFile;
  LPCSTR    lpParameters;
  LPCSTR    lpDirectory;
  int       nShow;
  HINSTANCE hInstApp;
  void      *lpIDList;
  LPCSTR    lpClass;
  HKEY      hkeyClass;
  DWORD     dwHotKey;
  union {
    HANDLE hIcon;
    HANDLE hMonitor;
  } DUMMYUNIONNAME;
  HANDLE    hProcess;
} SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;

회원

cbSize

형식: DWORD

필수. 이 구조체의 크기(바이트)입니다.

fMask

형식: ULONG

다른 구조체 멤버의 내용과 유효성을 나타내는 다음 값 중 하나 이상의 조합입니다.

hwnd

형식: HWND

선택적. 이 함수를 실행하는 동안 시스템에서 생성할 수 있는 UI를 표시하고 배치하는 데 사용되는 소유자 창에 대한 핸들입니다.

lpVerb

형식: LPCTSTR

수행할 작업을 지정하는 동사참조되는 문자열입니다. 사용 가능한 동사 집합은 특정 파일 또는 폴더에 따라 달라집니다. 일반적으로 개체의 바로 가기 메뉴에서 사용할 수 있는 동작은 동사를 사용할 수 있습니다. 이 매개 변수는 NULL수 있습니다. 이 경우 기본 동사가 사용 가능한 경우 사용됩니다. 그렇지 않은 경우 "open" 동사가 사용됩니다. 두 동사를 모두 사용할 수 없는 경우 시스템은 레지스트리에 나열된 첫 번째 동사를 사용합니다. 작업을 특정 동사로 제한할 이유가 없는 경우 계산된 기본값을 사용하도록 NULL을 전달합니다. 예를 들어 SEE_MASK_FLAG_NO_UI 지정하는 경우와 같이 앱이 설치되지 않은 경우 "Open With" UI를 생성하려는 경우가 있습니다.

일반적으로 사용되는 동사는 다음과 같습니다.

• 편집: 편집기를 시작하고 편집할 문서를 엽니다. lpFile 문서 파일이 아니면 함수가 실패합니다.
• 탐색: lpFile지정된 폴더를 탐색합니다.
• 찾기: 지정된 디렉터리부터 검색을 시작합니다.
• 열린: lpFile 매개 변수로 지정된 파일을 엽니다. 파일은 실행 파일, 문서 파일 또는 폴더일 수 있습니다.
• openas: 사용자가 lpFile 매개 변수로 지정된 파일을 열 앱을 선택할 수 있도록 선택기 UI를 시작합니다.
• 인쇄: lpFile지정한 문서 파일을 인쇄합니다. lpFile 문서 파일이 아니면 함수가 실패합니다.
• 속성: 파일 또는 폴더의 속성을 표시합니다.
• runas: 관리자 권한으로 애플리케이션을 시작합니다. UAC(사용자 계정 컨트롤)는 관리자 권한으로 애플리케이션을 실행하는 데 동의하라는 메시지를 표시하거나 애플리케이션을 실행하는 데 사용되는 관리자 계정의 자격 증명을 입력합니다.

lpFile

형식: LPCTSTR

ShellExecuteExlpVerb 매개 변수로 지정된 작업을 수행할 파일 또는 개체의 이름을 지정하는 null로 끝나는 문자열의 주소입니다. ShellExecuteEx 함수에서 지원하는 시스템 레지스트리 동사에는 실행 파일 및 문서 파일에 대한 "열기"와 인쇄 처리기가 등록된 문서 파일에 대한 "인쇄"가 포함됩니다. 다른 애플리케이션은 시스템 레지스트리를 통해 셸 동사를 추가했을 수 있습니다(예: .avi 및 .wav 파일에 대한 "재생"). Shell 네임스페이스 개체를 지정하려면 정규화된 구문 분석 이름을 전달하고 fMask 매개 변수에 SEE_MASK_INVOKEIDLIST 플래그를 설정합니다.

lpParameters

형식: LPCTSTR

선택적. 애플리케이션 매개 변수를 포함하는 null로 끝나는 문자열의 주소입니다. 매개 변수는 공백으로 구분해야 합니다. lpFile 멤버가 문서 파일을 지정하는 경우 lpParameters NULL합니다.

lpDirectory

형식: LPCTSTR

선택적. 작업 디렉터리의 이름을 지정하는 null로 끝나는 문자열의 주소입니다. 이 멤버가 NULL경우 현재 디렉터리가 작업 디렉터리로 사용됩니다.

nShow

형식: int

필수. 애플리케이션을 열 때 표시할 방법을 지정하는 플래그입니다. ShellExecute 함수에 대해 나열된 SW_ 값 중 하나입니다. lpFile 문서 파일을 지정하는 경우 플래그는 단순히 연결된 애플리케이션에 전달됩니다. 처리 방법을 결정하는 것은 애플리케이션에 달려 있습니다.

hInstApp

형식: HINSTANCE

[out] SEE_MASK_NOCLOSEPROCESS 설정되고 ShellExecuteEx 호출이 성공하면 이 멤버를 32보다 큰 값으로 설정합니다. 함수가 실패하면 실패의 원인을 나타내는 SE_ERR_XXX 오류 값으로 설정됩니다. hInstApp 16비트 Windows 애플리케이션과의 호환성을 위해 HINSTANCE로 선언되었지만 진정한 HINSTANCE는 아닙니다. int만 캐스팅할 수 있으며 32 또는 다음 SE_ERR_XXX 오류 코드와 비교할 수 있습니다.

lpIDList

형식: LPVOID

실행할 파일을 고유하게 식별하는 항목 식별자 목록을 포함하는 절대 ITEMIDLIST 구조체(PCIDLIST_ABSOLUTE)의 주소입니다. 이 멤버는 fMask 멤버에 SEE_MASK_IDLIST 또는 SEE_MASK_INVOKEIDLIST포함하지 않는 경우 무시됩니다.

lpClass

형식: LPCTSTR

다음 중 하나를 지정하는 null로 끝나는 문자열의 주소입니다.

• ProgId입니다. 예를 들어 "Paint.Picture"입니다.
• URI 프로토콜 체계입니다. 예를 들어 "http"입니다.
• 파일 확장명입니다. 예를 들어 ".txt"입니다.
• 하나 이상의 Shell 동사가 포함된 하위 키의 이름을 지정하는 HKEY_CLASSES_ROOT 아래의 레지스트리 경로입니다. 이 키에는 셸\동사 이름같은 셸 동사 레지스트리 스키마를 준수하는 하위 키가 있습니다.

fMaskSEE_MASK_CLASSNAME포함하지 않으면 이 멤버는 무시됩니다.

hkeyClass

형식: HKEY

파일 형식에 대한 레지스트리 키에 대한 핸들입니다. 이 레지스트리 키에 대한 액세스 권한은 KEY_READ 설정해야 합니다. fMaskSEE_MASK_CLASSKEY포함하지 않으면 이 멤버는 무시됩니다.

dwHotKey

형식: DWORD

애플리케이션과 연결할 바로 가기 키입니다. 하위 단어는 가상 키 코드이며, 상위 단어는 한정자 플래그(HOTKEYF_)입니다. 한정자 플래그 목록은 WM_SETHOTKEY 메시지에 대한 설명을 참조하세요. fMaskSEE_MASK_HOTKEY포함하지 않으면 이 멤버는 무시됩니다.

DUMMYUNIONNAME

DUMMYUNIONNAME.hIcon

형식: HANDLE

파일 형식의 아이콘에 대한 핸들입니다. fMaskSEE_MASK_ICON포함하지 않으면 이 멤버는 무시됩니다. 이 값은 Windows XP 및 이전 버전에서만 사용됩니다. Windows Vista에서 무시됩니다.

DUMMYUNIONNAME.hMonitor

형식: HANDLE

문서를 표시할 모니터에 대한 핸들입니다. fMaskSEE_MASK_HMONITOR포함하지 않으면 이 멤버는 무시됩니다.

hProcess

형식: HANDLE

새로 시작된 애플리케이션에 대한 핸들입니다. 이 멤버는 반환 시 설정되며 fMask SEE_MASK_NOCLOSEPROCESS설정되지 않는 한 항상 NULL . fMask SEE_MASK_NOCLOSEPROCESS설정하더라도 프로세스가 시작되지 않은 경우 hProcess NULL . 예를 들어 시작할 문서가 URL이고 Internet Explorer 인스턴스가 이미 실행 중인 경우 문서가 표시됩니다. 새 프로세스가 시작되지 않으며 hProcess NULL.

발언

SEE_MASK_NOASYNC 플래그는 ShellExecuteEx 호출하는 스레드에 메시지 루프가 없거나 ShellExecuteEx가 반환된 직후 스레드 또는 프로세스가 종료되는 경우 지정해야. 이러한 조건에서는 DDE 대화를 완료하는 데 호출 스레드를 사용할 수 없으므로 호출 애플리케이션으로 제어를 반환하기 전에 ShellExecuteEx 대화를 완료해야 합니다. 대화를 완료하지 못하면 문서가 시작되지 않을 수 있습니다.

호출 스레드에 메시지 루프가 있고 ShellExecuteEx 호출이 반환된 후 일정 시간 동안 존재하는 경우 SEE_MASK_NOASYNC 플래그는 선택 사항입니다. 플래그를 생략하면 호출 스레드의 메시지 펌프가 DDE 대화를 완료하는 데 사용됩니다. DDE 대화가 백그라운드에서 완료될 수 있으므로 호출 애플리케이션은 더 빨리 제어권을 되찾습니다.

lpParameters큰따옴표를 포함하려면 다음 예제와 같이 각 표시를 따옴표 쌍으로 묶습니다.

sei.lpParameters = "An example: \"\"\"quoted text\"\"\"";

이 경우 애플리케이션은 세 가지 매개 변수를 받습니다. , 예제:및 "따옴표 붙은 텍스트".

요구 사항