Fungsi CreateResourceManager (ktmw32.h)

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

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

[in, optional] lpResourceManagerAttributes

Penunjuk ke struktur SECURITY_ATTRIBUTES yang berisi atribut keamanan untuk resource manager. 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.

[in] TmHandle

Handel ke TM yang akan mengelola transaksi untuk RM ini.

[in, optional] Description

Deskripsi untuk RM ini.

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:

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. Volatil, atau sementara, RM 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 tahan lama, tetapi Anda tidak dapat membuat RM tahan lama pada TM yang mudah menguras.

Fungsi Manajer Transaksi Kernel

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort