Fungsi GetNotificationResourceManagerAsync (ktmw32.h)

Artikel
03/14/2023

Meminta dan menerima pemberitahuan asinkron untuk manajer sumber daya (RM). Fungsi ini digunakan oleh register RM untuk menerima pemberitahuan ketika transaksi berubah status.

Sintaks

BOOL GetNotificationResourceManagerAsync(
  [in]  HANDLE                    ResourceManagerHandle,
  [out] PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]  ULONG                     TransactionNotificationLength,
  [out] PULONG                    ReturnLength,
  [in]  LPOVERLAPPED              lpOverlapped
);

Parameter

[in] ResourceManagerHandle

Handel ke manajer sumber daya.

[out] TransactionNotification

Penunjuk ke struktur TRANSACTION_NOTIFICATION yang menerima pemberitahuan pertama yang tersedia.

[in] TransactionNotificationLength

Ukuran buffer TransactionNotification , dalam byte.

[out] ReturnLength

Penunjuk ke variabel yang menerima ukuran aktual pemberitahuan yang diterima oleh parameter TransactionNotification .

[in] lpOverlapped

Penunjuk ke struktur TUMPANG TINDIH yang diperlukan untuk operasi asinkron.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol (0). Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Daftar berikut mengidentifikasi kemungkinan kode kesalahan:

Keterangan

Semua manajer sumber daya harus mendaftar untuk menerima pemberitahuan TRANSACTION_NOTIFY_PREPREPARE, TRANSACTION_NOTIFY_PREPARE, dan TRANSACTION_NOTIFY_COMMIT , bahkan jika mereka kemudian memanggil ReadOnlyEnlistment untuk menandai pendaftaran sebagai baca-saja. Manajer sumber daya dapat mendukung TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT, tetapi mereka juga harus mendukung pemberitahuan pra-persiapan, persiapan, dan penerapan multi-fase. Untuk daftar semua pemberitahuan yang dapat diterima manajer sumber daya, lihat TRANSACTION_NOTIFICATION.

Resource manager (RM) mungkin ingin memanggil fungsi ini lebih dari sekali untuk menyediakan beberapa buffer untuk digunakan KTM saat mengirimkan pemberitahuan. Jumlah panggilan ke fungsi ini tergantung pada berapa banyak beban yang dibawa RM Anda.

Fungsi ini harus dipanggil setelah fungsi SetResourceManagerCompletionPort dipanggil.

Persyaratan


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