Metode IBidiRequest::GetOutputData (bidispl.h)

  • Artikel

Metode GetOutputData mendapatkan data output yang ditentukan yang kembali dari printer.

Sintaks

HRESULT GetOutputData(
  [in]  const DWORD dwIndex,
  [out] LPWSTR      *ppszSchema,
  [out] DWORD       *pdwType,
  [out] BYTE        **ppData,
  [out] ULONG       *uSize
);

Parameter

[in] dwIndex

Indeks berbasis nol dari data output yang diminta. Untuk informasi selengkapnya, lihat Keterangan.

[out] ppszSchema

Penunjuk ke string yang dihentikan NULL yang menerima string skema. Pemanggil harus memanggil fungsi CoTaskMemFree untuk membebaskan pointer ini.

[out] pdwType

Penunjuk ke variabel yang menerima jenis data output. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Deskripsi
BIDI_NULL Tidak ada data.
BIDI_INT Data bilangan bulat.
BIDI_FLOAT Angka titik mengambang.
BIDI_BOOL TRUE atau FALSE
BIDI_STRING String karakter Unicode.
BIDI_TEXT Untai (karakter) Unicode yang tidak dapat dilokalkan.
BIDI_ENUM Data enumerasi dalam bentuk string Unicode.
BIDI_BLOB Data biner.

[out] ppData

Penunjuk ke variabel yang menerima penunjuk ke array byte yang berisi data output. Buffer dialokasikan oleh antarmuka COM untuk menyimpan data output. Pemanggil bertanggung jawab untuk memanggil CoTaskMemFree untuk membebaskan buffer.

[out] uSize

Penunjuk ke variabel yang menerima ukuran array byte yang ditentukan oleh **ppData.

Nilai kembali

Metode mengembalikan salah satu nilai berikut. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Kode Kesalahan COM.

Menampilkan kode Deskripsi
S_OK Operasi berhasil dilakukan.
E_HANDLE Handel antarmuka tidak valid.
E_POINTER Setidaknya salah satu parameter variabel pointer tidak mereferensikan lokasi memori yang valid.
Tidak satu pun jawaban di atas HRESULT berisi kode kesalahan yang sesuai dengan kesalahan terakhir.

Keterangan

Satu permintaan bidi dapat memiliki beberapa hasil. Aplikasi memanggil GetEnumCount untuk mendapatkan jumlah hasil dari permintaan bidi.

Jika aplikasi memanggil GetOutputData dengan indeks yang sama dua kali, antarmuka mengalokasikan dua buffer yang berbeda dan dengan demikian aplikasi harus membebaskan kedua buffer.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP
Server minimum yang didukung Windows Server 2003
Target Platform Desktop
Header bidispl.h
DLL Bidispl.dll

Lihat juga

Antarmuka Komunikasi Dua Arah

Skema Komunikasi Dua Arah

GetEnumCount

IBidiRequest