atribut fault_status
Atribut ACF [fault_status] menentukan bahwa kode kesalahan jenis error_status_t menunjukkan kegagalan prosedur jarak jauh, bukan jenis masalah lain seperti kesalahan komunikasi.
[fault_status [ , ACF-function-attributes ] ] function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ... );
[ [ ACF-function-attributes ] ] function-name(
[fault_status [ , ACF-parameter-attributes ] ] parameter-name
, ... );
-
Acf-function-attributes
-
Menentukan nol atau beberapa atribut fungsi ACF seperti [fault_status] dan [nocode]. Atribut fungsi diapit dalam tanda kurung siku. Perhatikan bahwa nol atau beberapa atribut dapat diterapkan ke fungsi. Pisahkan beberapa atribut fungsi dengan koma. Perhatikan juga bahwa jika [fault_status] muncul sebagai atribut fungsi, itu juga tidak dapat muncul sebagai atribut parameter.
-
nama fungsi
-
Menentukan nama fungsi seperti yang didefinisikan dalam file IDL.
-
ACF-parameter-attributes
-
Menentukan atribut yang berlaku untuk parameter. Perhatikan bahwa nol atau beberapa atribut dapat diterapkan ke parameter . Atribut parameter diapit dalam tanda kurung siku. Pisahkan beberapa atribut parameter dengan koma. Atribut parameter IDL, seperti atribut arah, tidak diizinkan di ACF. Perhatikan bahwa jika [fault_status] muncul sebagai atribut parameter, itu juga tidak dapat muncul sebagai atribut fungsi.
-
Nama parameter
-
Menentukan parameter untuk fungsi seperti yang didefinisikan dalam file IDL. Setiap parameter untuk fungsi harus ditentukan dalam urutan yang sama, menggunakan nama yang sama seperti yang didefinisikan dalam file IDL.
Atribut [fault_status] dapat digunakan sebagai atribut fungsi atau sebagai atribut parameter, tetapi hanya dapat muncul sekali per fungsi. Ini dapat diterapkan baik ke fungsi itu sendiri atau ke satu parameter di setiap fungsi.
Atribut [fault_status] hanya dapat diterapkan ke fungsi yang mengembalikan jenis error_status_t. Ketika prosedur jarak jauh gagal dengan cara yang menyebabkan kesalahan PDU dikembalikan, kode kesalahan dikembalikan.
Ketika [fault_status] digunakan sebagai atribut parameter, parameter harus menjadi parameter [out] dari jenis error_status_t. Jika terjadi kesalahan server, parameter diatur ke kode kesalahan. Ketika panggilan jarak jauh berhasil diselesaikan, prosedur menetapkan nilai.
Parameter yang terkait dengan atribut [fault_status] tidak harus ditentukan dalam file IDL. Ketika parameter tidak ditentukan, parameter keluar baru dari jenis error_status_t dihasilkan mengikuti parameter terakhir yang ditentukan dalam file IDL DCE.
Atribut [fault_status] dan [comm_status] mungkin muncul dalam satu fungsi, baik sebagai atribut fungsi atau atribut parameter. Jika kedua atribut adalah atribut fungsi, atau jika berlaku untuk parameter yang sama dan tidak ada kesalahan yang terjadi, fungsi atau parameter memiliki nilai error_status_ok. Jika tidak, itu berisi nilai kode status yang sesuai. Karena nilai yang dikembalikan untuk [fault_status] berbeda dari nilai yang dikembalikan untuk [comm_status], nilai yang dikembalikan mudah ditafsirkan.