EngEnumForms 함수(winddi.h)

EngEnumForms 함수는 지정된 프린터에서 지원하는 양식을 열거합니다.

구문

ENGAPI BOOL EngEnumForms(
  [in]            HANDLE  hPrinter,
  [in]            DWORD   Level,
  [out, optional] LPBYTE  pForm,
  [in]            DWORD   cbBuf,
  [out]           LPDWORD pcbNeeded,
  [out]           LPDWORD pcReturned
);

매개 변수

[in] hPrinter

폼을 열거해야 하는 프린터에 대한 핸들입니다. DrvEnablePDEV의 hDriver 매개 변수로 전달되는 PDEV 핸들입니다.

[in] Level

pForm에서 가리키는 구조체의 버전을 지정합니다. 이 값은 1이어야 하며, 이는 열거된 양식이 FORM_1_INFO 구조체에서 반환되어야 했음을 나타냅니다.

[out, optional] pForm

열거형 FORM_INFO_1 구조체가 기록되는 바이트 배열에 대한 포인터입니다.

[in] cbBuf

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

[out] pcbNeeded

복사본이 성공적으로 완료된 경우 pForm 에 복사된 바이트 수를 받는 DWORD에 대한 포인터입니다. pForm이 너무 작아서 열거된 폼의 데이터를 모두 포함할 수 없는 경우 이 DWORD는 필요한 바이트 수를 지정합니다.

[out] pcReturned

pForm에 복사된 FORM_INFO_1 구조체 수를 수신하는 DWORD에 대한 포인터입니다.

반환 값

모든 매개 변수가 유효하고 열거된 양식 데이터가 pForm에 성공적으로 복사되면 EngEnumForms는 TRUE를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 오류 메시지가 기록됩니다. 오류 정보를 얻으려면 EngGetLastError를 호출합니다.

설명

프린터 드라이버는 EngEnumForms 를 호출하여 GDI가 특정 프린터에서 지원하는 양식 목록을 가져오도록 할 수 있습니다. 열거된 정보는 pForm에서 가리키는 FORM_INFO_1 구조체(Microsoft Windows SDK 설명서에 선언됨)의 배열로 반환됩니다. pForm이 가리키는 배열이 열거된 데이터를 저장할 만큼 크지 않으면 필수 배열 크기가 pcbNeeded에 반환됩니다.

요구 사항

추가 정보

DrvEnablePDEV

EngGetLastError