EngSetPrinterData 함수(winddi.h)

EngSetPrinterData 함수는 Windows 2000 이상에서 사용되지 않습니다.

이전 버전의 Windows EngSetPrinterData 에서는 지정된 프린터의 구성 데이터를 설정합니다.

구문

ENGAPI DWORD EngSetPrinterData(
  [in] HANDLE hPrinter,
  [in] LPWSTR pType,
  [in] DWORD  dwType,
  [in] LPBYTE lpbPrinterData,
  [in] DWORD  cjPrinterData
);

매개 변수

[in] hPrinter

구성 데이터를 설정해야 하는 프린터에 대한 핸들입니다. DrvEnablePDEV의 hDriver 매개 변수로 전달되는 핸들입니다. 설명을 참조하세요.

[in] pType

설정할 데이터를 식별하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] dwType

설정할 정보의 유형을 지정하는 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
REG_BINARY	모든 형태의 이진 데이터입니다.
REG_DWORD	32비트 숫자입니다.
REG_DWORD_BIG_ENDIAN	big-endian 형식의 32비트 숫자로, 단어의 가장 중요한 바이트가 낮은 바이트임을 의미합니다.
REG_DWORD_LITTLE_ENDIAN	little-endian 형식(REG_DWORD 동일)의 32비트 숫자로, 단어의 가장 중요한 바이트가 상위 바이트임을 의미합니다.
REG_EXPAND_SZ	환경 변수에 대한 확장되지 않은 참조를 포함하는 null로 끝나는 문자열입니다(예: "%PATH%"). 유니코드 또는 ANSI 함수가 사용되는지 여부에 따라 유니코드 또는 ANSI 문자열이 됩니다.
REG_LINK	유니코드 기호 링크입니다.
REG_MULTI_SZ	두 null 문자로 끝나는, null로 끝나는 문자열의 배열입니다.
REG_NONE	정의된 값 형식이 없습니다.
REG_RESOURCE_LIST	디바이스 드라이버 리소스 목록입니다.
REG_SZ	null로 끝나는 문자열입니다. 유니코드 또는 ANSI 함수를 사용하는지 여부에 따라 유니코드 또는 ANSI 문자열이 됩니다.

[in] lpbPrinterData

설정할 프린터 구성 데이터에 대한 포인터입니다. 가리키는 데이터 형식은 dwType에 의해 결정됩니다.

[in] cjPrinterData

lpbPrinterData의 크기(바이트)를 지정합니다.

반환 값

EngSetPrinterData 는 마지막으로 기록된 오류 메시지를 반환합니다.

설명

Microsoft Windows 2000부터 이 함수는 사용되지 않습니다. EngSetPrinterData 및 DrvEnablePDEV 함수에 대한 호출에 사용되는 핸들은 액세스 권한이 다릅니다. 따라서 이러한 함수는 더 이상 함께 작동하지 않습니다. DrvEnablePDEV 함수 호출에 사용되는 hDriver 매개 변수는 PRINTER_ACCESS_USE 액세스 권한으로 열립니다. 반면 EngSetPrinterData 함수 호출에 사용되는 hPrinter 매개 변수는 PRINTER_ALL_ACCESS 액세스 권한으로 열려 있어야 합니다. 따라서 커널 모드 프린터 드라이버( EngSetPrinterData를 호출할 수 있는 유일한 프린터 드라이버 유형)가 EngSetPrinterData 를 사용하여 프린터에 대한 정보를 레지스트리에 쓸 수 있는 방법은 없습니다.

프린터 액세스 권한에 대한 자세한 내용은 PRINTER_DEFAULTS 구조(Windows SDK 설명서에 설명됨)를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	winddi.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys

추가 정보

DrvEnablePDEV

EngGetPrinterData