ncacn_np屬性

ncacn_np關鍵字會將具名管道識別為端點的通訊協定系列。

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

參數

server-name

選擇性。 指定伺服器的名稱。 反斜線字元是選擇性的。

pipe-name

指定有效的管道名稱。 有效的管道名稱是字串，其中包含以反斜線字元分隔的識別碼。 第一個識別碼必須是 管道。 每個識別碼都必須以兩個反斜線字元分隔。

備註

伺服器會建立具名管道的實例，然後可供任何用戶端使用。 當用戶端嘗試連線時，現有的實例會與該用戶端相關聯。 在另一個用戶端可以連線之前，伺服器必須建立另一個具名管道實例。 如果用戶端嘗試在建立新實例之前系結至伺服器， 則系結呼叫 RpcBindingFromStringBinding可能會失敗，並出現錯誤訊息RPC_S_SERVER_TOO_BUSY。 因此，您必須確定用戶端應用程式會處理伺服器太忙碌而無法接受連線的情況。 用戶端應該會自動重試、提示使用者採取動作，或正常失敗。

具名管道埠字串的語法就像所有埠字串一樣，是由傳輸實作所定義，而且與 IDL 規格無關。 MIDL 編譯器會執行有限的語法檢查，但不保證端點規格正確。 某些錯誤類別可能會在執行時間報告，而不是在編譯時期報告。

範例

[
    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.
}

另請參閱

端點

介面定義 (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

字串系結