EnumPrintProcessorDatatypes
The EnumPrintProcessorDatatypes
function enumerates the data types that a specifed print processor supports.
BOOL EnumPrintProcessorDatatypes(
|
LPTSTR pName, |
// points to server
name string |
|
LPTSTR pPrintProcessorName, |
// points to print
processor name string |
|
DWORD Level, |
// specifies
version of print processor data type structures |
|
LPBYTE pDatatypes, |
// points to buffer
to receive print processor data type structures |
|
DWORD cbBuf, |
// specifies size,
in bytes, of buffer |
|
LPDWORD pcbNeeded, |
// points to number
of bytes copied (or required) |
|
LPDWORD pcReturned |
// points to number
of data structures obtained |
|
); |
|
Parameters
pName
Points to a
null-terminated string that specifies the name of the server on which the print
processor resides. If this parameter is NULL, the data types for the local
print processor are enumerated.
pPrintProcessorName
Points to a
null-terminated string that specifies the name of the print processor whose
data types are to be enumerated.
Level
Specifies the
version of the print-processor data type structures to be stored in the buffer
pointed to by pDatatypes. This parameter must be 1.
pDatatypes
Points to an
array of DATATYPES_INFO_1
structures. One structure is created for each available data type.
cbBuf
Specifies the
size, in bytes, of the buffer pointed to by pDatatypes.
pcbNeeded
Points to a
variable to receive the total size, in bytes, of the array of DATATYPES_INFO_1 structures.
If this value
is less than or equal to cbBuf and the function succeeds, this is the
number of bytes stored in the buffer pointed to by pDatatypes. If this
number is greater than cbBuf, the buffer is too small, and you must call
the function again with a buffer size at least as large as *pcbNeeded.
pcReturned
Points to a
variable that the function sets to the number of data structures stored in the
buffer pointed to by pDatatypes.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
See Also