atribut ncacn_np

  • Artikel

Kata kunci ncacn_np mengidentifikasi pipa bernama sebagai keluarga protokol untuk titik akhir.

endpoint("ncacn_np:server-name[\\pipe\\pipe-name]")

Parameter

nama server

Opsional. Menentukan nama server. Karakter garis miring terbelakang bersifat opsional.

pipe-name

Menentukan nama pipa yang valid. Nama pipa yang valid adalah string yang berisi pengidentifikasi yang dipisahkan oleh karakter garis miring terbelakang. Pengidentifikasi pertama harus pipa. Setiap pengidentifikasi harus dipisahkan oleh dua karakter garis miring terbalik.

Keterangan

Server membuat instans pipa bernama yang kemudian tersedia untuk klien mana pun. Ketika klien mencoba menyambungkan, instans yang ada dikaitkan dengan klien tersebut. Sebelum klien lain dapat tersambung, server harus membuat instans lain dari pipa bernama. Jika klien mencoba mengikat ke server sebelum instans baru dibuat, panggilan pengikatan, RpcBindingFromStringBinding, mungkin gagal dengan pesan kesalahan RPC_S_SERVER_TOO_BUSY. Oleh karena itu, Anda perlu memastikan bahwa aplikasi klien Anda menangani kasus di mana server terlalu sibuk untuk menerima koneksi. Klien harus secara otomatis mencoba kembali, meminta pengguna untuk tindakan, atau gagal dengan baik.

Sintaks string port named-pipe, seperti semua string port, didefinisikan oleh implementasi transportasi dan tidak bergantung pada spesifikasi IDL. Kompilator MIDL melakukan pemeriksaan sintaks terbatas tetapi tidak menjamin bahwa spesifikasi titik akhir sudah benar. Beberapa kelas kesalahan dapat dilaporkan pada durasi daripada pada waktu kompilasi.

Contoh

[
    uuid(12345678-4000-2006-0000-20000000001a), 
    version(1.1), 
    endpoint("ncacn_np:[\\pipe\\stove\\hat]") 
] 
interface iface1
{
    // Interface definition statements.
}

[
    uuid(87654321-4000-2006-0000-20000000001b), 
    version(1.1), 
    endpoint("ncacn_np:\\\\myotherserver[\\pipe\\corncob]") 
] 
interface iface2
{
    // Interface definition statements.
}

Lihat juga

Endpoint

File Definisi Antarmuka (IDL)

ncacn_at_dsp

ncacn_dnet_nsp

ncacn_ip_tcp

ncacn_nb_ipx

ncacn_spx

ncacn_nb_nb

ncacn_nb_tcp

ncacn_vns_spp

ncalrpc

ncadg_ipx

ncadg_ip_udp

pengikatan string