SHInvokePrinterCommandW 함수(shellapi.h)

아티클
08/08/2024

프린터 개체에서 명령을 실행합니다.

참고 이 함수는 Windows Vista를 기준으로 사용되지 않습니다. IContextMenu 또는 ShellExecute를 통해 프린터에서 동사를 호출하는 것이 좋습니다.

구문

BOOL SHInvokePrinterCommandW(
  [in, optional] HWND    hwnd,
                 UINT    uAction,
  [in]           LPCWSTR lpBuf1,
  [in, optional] LPCWSTR 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 헤더는 SHInvokePrinterCommand를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shellapi.h
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 4.71 이상)

다음을 통해 공유