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 durasi. Tidak seperti array yang sesuai, pengembang tidak harus memberikan 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 [ out, string] mengarahkan stub untuk meneruskan string dari server ke klien saja. Desain call-by-value bahasa C menegaskan bahwa semua parameter [out] harus pointer.

Parameter [out] harus berupa pointer dan, secara default, semua parameter pointer adalah penunjuk referensi. Penunjuk referensi tidak berubah selama panggilan—menunjuk ke memori yang sama seperti sebelum panggilan. Untuk penunjuk string, batasan tambahan dari penunjuk referensi berarti klien harus mengalokasikan memori yang valid yang cukup sebelum melakukan panggilan prosedur jarak jauh. Stub mengirimkan string yang ditunjukkan 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] Prototype