Metode IPortableDeviceResources::CreateResource (portabledeviceapi.h)

  • Artikel

Metode CreateResource membuat sumber daya.

Sintaks

HRESULT CreateResource(
  [in]  IPortableDeviceValues *pResourceAttributes,
  [out] IStream               **ppData,
  [out] DWORD                 *pdwOptimalWriteBufferSize,
  [out] LPWSTR                *ppszCookie
);

Parameter

[in] pResourceAttributes

Arahkan ke atribut parameter objek berikut.

Atribut Deskripsi
WPD_OBJECT_NAME Nama objek.
WPD_RESOURCE_ATTRIBUTE_TOTAL_SIZE Ukuran total aliran data sumber daya.
WPD_RESOURCE_ATTRIBUTE_FORMAT Format aliran data sumber daya.
WPD_RESOURCE_ATTRIBUTE_RESOURCE_KEY Kunci sumber daya.

[out] ppData

Arahkan ke aliran tempat penelepon dapat menulis data sumber daya.

[out] pdwOptimalWriteBufferSize

Penunjuk ke nilai yang menentukan ukuran buffer optimal saat menulis ke aliran. Parameter ini bersifat opsional.

[out] ppszCookie

Penunjuk ke cookie yang mengidentifikasi permintaan pembuatan sumber daya. Parameter ini bersifat opsional.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_POINTER
 Setidaknya salah satu argumen adalah penunjuk NULL .

Keterangan

Ketika aplikasi memanggil metode ini, aplikasi harus menentukan atribut sumber daya dan harus menulis data yang diperlukan ke aliran yang dikembalikan metode ini.

Sumber daya tidak dibuat ketika metode kembali; ini dibuat ketika aplikasi menerapkan data dengan memanggil metode Penerapan pada aliran di mana ppData menunjuk.

Untuk membatalkan transfer data ke sumber daya, aplikasi harus memanggil metode Kembalikan pada aliran tempat ppData menunjuk. Setelah transfer dibatalkan, aplikasi harus memanggil IUnknown::Release untuk menutup aliran.

Persyaratan

   
Target Platform Windows
Header portabledeviceapi.h
Pustaka PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceResources