EnumPrintProcessorDatatypesA 함수(winspool.h)

인쇄 프로세서의 EnumPrintProcessorDatatypes 함수는 인쇄 프로세서가 지원하는 데이터 형식을 열거합니다.

구문

BOOL EnumPrintProcessorDatatypesA(
  [in, optional]  LPSTR   pName,
  [in]            LPSTR   pPrintProcessorName,
                  DWORD   Level,
  [out, optional] LPBYTE  pDatatypes,
                  DWORD   cbBuf,
  [out]           LPDWORD pcbNeeded,
  [out]           LPDWORD pcReturned
);

매개 변수

[in, optional] pName

인쇄 프로세서가 설치된 서버의 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다. NULL인 경우 서버는 로컬 시스템입니다.

[in] pPrintProcessorName

인쇄 프로세서 이름을 나타내는 문자열에 대한 호출자 제공 포인터입니다.

Level

pDatatypes가 가리키는 버퍼에 반환될 구조체의 형식을 나타내는 호출자 제공 값입니다. 구조체가 DATATYPES_INFO_1 나타내는 이 값은 1이어야 합니다.

[out, optional] pDatatypes

버퍼에 대한 호출자 제공 포인터로 DATATYPES_INFO_1 구조체의 배열과 데이터 형식 이름을 나타내는 문자열 집합을 수신합니다. DATATYPES_INFO_1 구조는 Microsoft Windows SDK 설명서에 설명되어 있습니다. 구조체 멤버 pName 은 LPWSTR 형식이어야 합니다.

cbBuf

pDatatypes가 가리키는 버퍼의 크기(바이트)를 나타내는 호출자 제공 값입니다.

[out] pcbNeeded

pDatatypes가 가리키는 버퍼에 필요한 최소 크기를 받을 위치에 대한 호출자 제공 포인터입니다.

[out] pcReturned

pDatatypes가 가리키는 버퍼에 반환된 DATATYPES_INFO_1 구조체의 수를 수신하는 위치에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다. 작업이 실패하면 함수는 SetLastError 를 호출하여 오류 코드를 설정한 다음 FALSE를 반환해야 합니다.

설명

EnumPrintProcessorDatatypes 함수를 내보내려면 인쇄 프로세서가 필요합니다. 로컬 인쇄 공급자는 초기화 중에 함수를 호출합니다. 애플리케이션이 동일한 함수의 스풀러 버전을 호출할 때도 함수가 호출됩니다.

함수는 각 구조체가 데이터 형식을 나타내는 문자열을 가리키는 DATATYPES_INFO_1 구조체의 배열을 반환해야 합니다. 실제 문자열도 구조 배열 다음에 버퍼에 포함되어야 합니다. 예제는 샘플 인쇄 프로세서 를 참조하세요.

함수는 pcReturned이 가리키는 위치에 반환된 DATATYPES_INFO_1 구조체(즉, 지원되는 데이터 형식 수)의 수를 반환해야 합니다.

함수는 pcbNeeded가 가리키는 위치에서 필요한 최소 버퍼 크기를 반환해야 합니다. 제공된 버퍼가 너무 작은 경우 함수는 pcbNeeded에 대한 값을 지정하고 오류 코드를 ERROR_INSUFFICIENT_BUFFER 설정하고 FALSE를 반환해야 합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	winspool.h(Winspool.h 포함)