SHInvokePrinterCommandA 함수(shellapi.h)
프린터 개체에서 명령을 실행합니다.
구문
BOOL SHInvokePrinterCommandA(
[in, optional] HWND hwnd,
UINT uAction,
[in] LPCSTR lpBuf1,
[in, optional] LPCSTR lpBuf2,
BOOL fModal
);
매개 변수
[in, optional] hwnd
형식: HWND
작업 중에 생성된 모든 창 또는 대화 상자의 부모 창 핸들입니다.
uAction
형식: UINT
수행할 프린터 작업의 유형입니다. 다음 값 중 하나입니다.
PRINTACTION_OPEN (0)
0x0. lpBuf1로 지정된 프린터를 엽니다. lpBuf2 매개 변수는 무시됩니다.
PRINTACTION_PROPERTIES (1)
0x1. lpBuf1로 지정된 프린터의 속성 페이지를 표시합니다. lpBuf2 매개 변수는 NULL이거나 이름 또는 숫자로 표시할 특정 속성 시트의 이름을 지정할 수 있습니다. lpBuf2의 높은 WORD가 0이 아닌 경우 이 매개 변수는 열 시트의 이름을 포함하는 버퍼에 대한 포인터라고 가정합니다. 그렇지 않으면 lpBuf2 는 열 속성 시트의 인덱스(0부터 시작)로 표시됩니다.
PRINTACTION_NETINSTALL (2)
0x2. lpBuf1로 지정된 네트워크 프린터를 설치합니다. lpBuf2 매개 변수는 무시됩니다.
PRINTACTION_NETINSTALLLINK (3)
0x3. lpBuf1로 지정된 네트워크 프린터에 대한 바로 가기를 만듭니다. lpBuf2 매개 변수는 바로 가기를 만들 폴더의 드라이브와 경로를 지정합니다. 네트워크 프린터가 로컬 컴퓨터에 이미 설치되어 있어야 합니다.
PRINTACTION_TESTPAGE (4)
0x4. lpBuf1로 지정된 프린터에 테스트 페이지를 인쇄합니다. lpBuf2 매개 변수는 무시됩니다.
PRINTACTION_OPENNETPRN (5)
0x5. lpBuf1로 지정된 네트워크 프린터를 엽니다. lpBuf2 매개 변수는 무시됩니다.
PRINTACTION_DOCUMENTDEFAULTS (6)
0x6. lpBuf1로 지정된 프린터의 기본 문서 속성을 표시합니다. lpBuf2 매개 변수는 무시됩니다.
PRINTACTION_SERVERPROPERTIES (7)
0x7. lpBuf1로 지정된 프린터 서버의 속성을 표시합니다. lpBuf2 매개 변수는 무시됩니다.
[in] lpBuf1
형식: LPCTSTR
프린터 명령에 대한 추가 정보가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수에 포함된 정보는 uAction 값에 따라 달라집니다.
[in, optional] lpBuf2
형식: LPCTSTR
프린터 명령에 대한 추가 정보가 포함된 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수에 포함된 정보는 uAction 값에 따라 달라집니다.
fModal
형식: BOOL
TRUE 이면 명령이 완료될 때까지 SHInvokePrinterCommand 가 반환되지 않도록 지정합니다. FALSE 이면 명령이 초기화되는 즉시 함수가 반환됩니다.
반환 값
형식: BOOL
성공하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.
설명
lpBuf1로 프린터 이름을 지정하는 경우 이름은 로컬 프린터 또는 서버의 이름이고 네트워크 프린터의 공유 이름이 될 수 있습니다. 네트워크 프린터 이름을 지정할 때 이름은 다음 형식으로 지정해야 합니다.
"\\<server><shared printer name>"
이 함수는 셸 버전 4.71 이상에서 구현됩니다. 이전 셸 버전과의 호환성을 유지하기 위해 이 함수를 명시적으로 사용하면 안 됩니다. 대신 LoadLibrary 및 GetProcAddress 함수를 사용하여 함수 주소를 가져와야 합니다.
참고
shellapi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SHInvokePrinterCommand를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | shellapi.h |
| 라이브러리 | Shell32.lib |
| DLL | Shell32.dll(버전 4.71 이상) |