atribut string (RPC)

Atribut [ string] menunjukkan bahwa parameter adalah penunjuk ke array jenis karakter, byte, atau w_char. Seperti halnya array yang sesuai, ukuran parameter [string] ditentukan pada waktu proses. Tidak seperti array yang sesuai, pengembang tidak perlu menyediakan panjang yang terkait dengan array —atribut [string] memberi tahu stub untuk menentukan ukuran array dengan memanggil strlen. Atribut [string] tidak dapat digunakan pada saat yang sama dengan atribut [ length_is] atau [ last_is] .

Kombinasi atribut [in, string] mengarahkan stub untuk meneruskan string dari klien ke server saja. Jumlah memori yang dialokasikan di server sama dengan ukuran string yang ditransmisikan ditambah satu.

Atribut [ keluar, string] mengarahkan stub untuk meneruskan string dari server ke klien saja. Desain call-by-value bahasa C bersikeras bahwa semua parameter [out] harus berupa pointer.

Parameter harus berupa penunjuk dan, secara default, semua parameter penunjuk adalah penunjuk referensi. Penunjuk referensi tidak berubah selama panggilan—menunjuk ke memori yang sama seperti sebelum panggilan. Untuk penunjuk string, batasan tambahan penunjuk referensi berarti klien harus mengalokasikan memori yang valid yang memadai sebelum melakukan panggilan prosedur jarak jauh. Stub mengirimkan string yang ditunjukkan oleh atribut [out, string] ke dalam memori yang sudah dialokasikan di sisi klien.

Topik berikut menjelaskan prototipe parameter prosedur jarak jauh untuk string:

• [in, out, string] Prototipe
• [in, string] dan [out, string] Prototipe