Fungsi CreateResourceManager (ktmw32.h)

Membuat objek resource manager (RM) baru, dan mengaitkan RM dengan manajer transaksi (TM).

Sintaks

HANDLE CreateResourceManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
  [in]           LPGUID                ResourceManagerId,
  [in, optional] DWORD                 CreateOptions,
  [in]           HANDLE                TmHandle,
  [in, optional] LPWSTR                Description
);

Parameter

[in, optional] lpResourceManagerAttributes

Penunjuk ke struktur SECURITY_ATTRIBUTES yang berisi atribut keamanan untuk manajer sumber daya. Tentukan NULL untuk mendapatkan atribut default.

[in] ResourceManagerId

Pointer GUID resource manager. Parameter ini diperlukan dan tidak boleh NULL.

[in, optional] CreateOptions

Atribut opsional apa pun untuk RM baru.

Nilai	Makna
RESOURCE_MANAGER_VOLATILE	Menunjukkan bahwa RM volatil, dan tidak melakukan pemulihan.

[in] TmHandle

Handel ke TM yang akan mengelola transaksi untuk RM ini.

[in, optional] Description

Deskripsi untuk RM ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke RM.

Jika fungsi gagal, nilai yang dikembalikan adalah INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Daftar berikut mengidentifikasi kemungkinan kode kesalahan:

Keterangan

Segera setelah memanggil fungsi ini, Anda harus memanggil RecoverResourceManager.

RM adalah titik akhir untuk pemberitahuan TM mengenai transaksi yang telah terdaftar di RM.

RM biasanya persisten, yang berarti bahwa setelah kegagalan sistem, RM harus dibuka kembali untuk melakukan operasi tertentu. RM volatil atau sementara dapat dibuat dengan memanggil fungsi CreateResourceManager dan dengan menentukan RESOURCE_MANAGER_VOLATILE. RM volatil tidak melakukan operasi pemulihan, tetapi memerlukan pemberitahuan tentang transaksi.

Anda dapat membuat RM volatil pada TM yang tahan lama, tetapi Anda tidak dapat membuat RM yang tahan lama pada TM yang volatil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	ktmw32.h
Pustaka	Ktmw32.lib
DLL	Ktmw32.dll

Lihat juga

Fungsi Manajer Transaksi Kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort