atribut comm_status
Atribut ACF [comm_status] menyebabkan kode kesalahan dikembalikan ketika terjadi kesalahan komunikasi selama eksekusi fungsi.
[comm_status [ , ACF-function-attributes ] ]
error_status_t function-name(
[ [ ACF-parameter-attributes ] ] parameter-name
, ...);
[ [ ACF-function-attributes ] ] function-name(
[comm_status [ , ACF-parameter-attributes ] ] error_status_t name
, ...);
Parameter
-
Acf-function-attributes
-
Menentukan atribut fungsi ACF nol atau lebih, seperti [comm_status] dan [nocode]. Atribut fungsi diapit dalam tanda kurung siku. Nol atau lebih atribut dapat diterapkan ke fungsi. Pisahkan beberapa atribut fungsi dengan koma. Perhatikan bahwa jika [comm_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, satu, atau beberapa atribut dapat diterapkan ke parameter . Pisahkan beberapa atribut parameter dengan koma. Atribut parameter diapit dalam tanda kurung siku. Atribut parameter IDL, seperti atribut arah, tidak diizinkan di ACF. Perhatikan bahwa jika [comm_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.
Keterangan
Atribut [comm_status] dapat digunakan sebagai atribut fungsi atau sebagai atribut parameter, tetapi hanya dapat muncul sekali per fungsi. Ini dapat diterapkan baik ke fungsi atau ke satu parameter di setiap fungsi.
Atribut [comm_status] hanya dapat diterapkan ke fungsi yang mengembalikan jenis error_status_t. Ketika terjadi kesalahan komunikasi selama eksekusi fungsi, kode kesalahan dikembalikan.
Ketika [comm_status] digunakan sebagai atribut parameter, parameter harus didefinisikan dalam file IDL dan harus menjadi parameter [out] dari jenis error_status_t. Ketika kesalahan komunikasi terjadi selama eksekusi fungsi, parameter diatur ke kode kesalahan. Ketika panggilan jarak jauh berhasil diselesaikan, prosedur akan menetapkan nilai.
Atribut [comm_status] dan [fault_status] mungkin muncul dalam satu fungsi, baik sebagai atribut fungsi atau atribut parameter. Jika kedua atribut adalah atribut fungsi atau jika diterapkan ke parameter yang sama dan tidak ada kesalahan yang terjadi, fungsi atau parameter memiliki nilai error_status_ok. Jika tidak, itu berisi nilai [comm_status] atau [fault_status] yang sesuai. Karena nilai yang dikembalikan untuk [comm_status] berbeda dari nilai yang dikembalikan untuk [fault_status], nilai yang dikembalikan mudah ditafsirkan.
Lihat juga