EngGetForm 함수(winddi.h)

EngGetForm 함수는 지정된 양식에 대한 FORM_INFO_1 세부 정보를 가져옵니다.

구문

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

매개 변수

[in] hPrinter

폼을 지정하는 프린터에 대한 핸들입니다.

[in] pFormName

폼의 이름을 지정하는 문자열에 대한 포인터입니다.

[in] Level

pForm이 가리키는 양식 구조의 버전을 지정합니다. 이 값은 양식 정보가 FORM_INFO_1 구조체에서 반환됨을 나타내는 1이어야 합니다.

[in, optional] pForm

초기화된 FORM_INFO_1 구조를 수신하는 바이트 배열에 대한 포인터입니다.

[in] cbBuf

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

[out] pcbNeeded

함수가 성공하면 pForm 이 가리키는 버퍼에 복사된 바이트 수를 지정하는 값에 대한 포인터입니다. 값은 cbBuf가 너무 작은 경우 복사를 수행하는 데 필요한 바이트 수입니다.

반환 값

양식 구조가 pForm에 성공적으로 복사되면 EngGetForm은 TRUE를 반환합니다. 그렇지 않으면 오류 메시지를 기록하고 FALSE를 반환합니다. 오류 정보를 얻으려면 EngGetLastError를 호출합니다.

설명

EngGetForm은 pFormName과 연결된 양식 데이터를 포함하는 Microsoft Windows SDK 설명서에 설명된 FORM_INFO_1 구조를 반환합니다. 기록된 데이터와 해당 크기는 각각 pForm 및 pcbNeeded를 통해 호출자에게 반환됩니다. pForm에서 가리키는 배열이 양식 데이터를 저장할 만큼 크지 않으면 필수 배열 크기가 pcbNeeded에 반환됩니다.

지원되는 모든 양식의 목록을 얻으려면 프린터 드라이버가 EngEnumForms를 호출해야 합니다.

요구 사항

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

추가 정보

EngEnumForms

EngGetLastError