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 所指向之緩衝區中傳回之結構的型別。 這個值必須是 1，表示結構DATATYPES_INFO_1。

[out, optional] pDatatypes

呼叫端提供的緩衝區指標，以接收DATATYPES_INFO_1結構的陣列，後面接著一組代表數據類型名稱的字元字串。 Microsoft Windows SDK 檔中會說明DATATYPES_INFO_1結構。 結構成員 pName 的類型必須是 LPWSTR。

cbBuf

呼叫端提供的值，代表 pDatatypes 所指向之緩衝區的大小，以位元組為單位。

[out] pcbNeeded

呼叫端提供的位置指標，以接收 pDatatypes 所指向之緩衝區所需的最小大小。

[out] pcReturned

呼叫端提供的位置指標，以接收 pDatatypes 所指向之緩衝區中傳回的DATATYPES_INFO_1結構數目。

傳回值

如果作業成功，函式應該會傳回 TRUE。 如果作業失敗，函式應該呼叫 SetLastError 來設定錯誤碼，然後傳回 FALSE。

備註

需要列印處理器才能導出 EnumPrintProcessorDatatypes 函式 。 本機列印提供者會在初始化期間呼叫 函式。 當應用程式呼叫同一個函式的 spooler 版本時，也會呼叫 函式。

函式必須傳回DATATYPES_INFO_1結構的數位，每個結構都指向代表數據類型的字串。 在結構陣列之後，實際字串也必須包含在緩衝區中。 如需範例，請參閱 範例列印處理器 。

函式應該會傳回傳回 (DATATYPES_INFO_1 結構的數目，也就是 pcReturned所指向位置所支援) 資料類型數目。

函式應該會傳回 由其指向之位置中最小所需的緩衝區大小。 如果提供的緩衝區太小，則函式應該指定 適用於ERROR_INSUFFICIENT_BUFFER，並將錯誤碼設定為 ERROR_INSUFFICIENT_BUFFER，並傳回 FALSE。

規格需求

需求	值
目標平台	桌面
標頭	winspool.h (包含 Winspool.h)