Fungsi RpcErrorStartEnumeration (rpcasync.h)

Artikel
08/25/2023

Fungsi RpcErrorStartEnumeration memulai enumerasi informasi kesalahan yang diperluas.

Sintaks

RPC_STATUS RpcErrorStartEnumeration(
  RPC_ERROR_ENUM_HANDLE *EnumHandle
);

Parameter

EnumHandle

Arahkan ke handel enumerasi, dalam bentuk struktur RPC_ERROR_ENUM_HANDLE . Struktur harus dialokasikan oleh pemanggil, dan tidak dapat dikosongkan sampai operasi selesai. Semua anggota diabaikan pada input.

Menampilkan nilai

Penyelesaian yang berhasil mengembalikan RPC_S_OK.

Mengembalikan RPC_S_ENTRY_NOT_FOUND jika tidak ada informasi kesalahan yang diperluas ada di utas. Jika enumerasi sedang berlangsung, memulai enumerasi kedua dimulai dari awal.

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

Keterangan

Panggilan fungsi RpcErrorStartEnumeration harus dilakukan segera setelah panggilan yang mengembalikan kesalahan. Jika tidak, informasi kesalahan yang diperluas dapat ditimpa oleh panggilan berikutnya. Handel enumerasi harus dikosongkan dengan fungsi RpcErrorEndEnumeration.

Setelah RpcErrorStartEnumeration dipanggil, aman untuk menggunakan handel enumerasi dari utas yang berbeda. Fungsi RpcErrorStartEnumeration mengambil rekam jepret dari informasi kesalahan yang diperluas, dan handel enumerasi yang kembali beroperasi pada rekam jepret. Namun, fungsi enumerasi tidak disinkronkan antara utas dengan RPC, sehingga pemanggil bertanggung jawab untuk melakukannya. Panggilan berikutnya ke RpcErrorStartEnumeration memulai enumerasi baru, dan tidak membuat enumerasi kedua untuk informasi kesalahan yang diperluas yang sama.

Fungsi RpcErrorStartEnumeration mungkin gagal jika tidak ada cukup memori untuk memulai enumerasi. Handel enumerasi hanya dapat diteruskan ke fungsi RpcError*, dan tidak dapat digunakan dengan fungsi lain, seperti DuplicateHandle.

Memajukan penunjuk enumerasi pada satu enumerasi tidak berpengaruh pada enumerasi yang dimulai secara independen.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	rpcasync.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll