ncacn_np属性

[アーティクル]
06/13/2023

ncacn_np キーワード (keyword)は、名前付きパイプをエンドポイントのプロトコルファミリとして識別します。

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

パラメーター

server-name: 省略可能。サーバーの名前を指定します。円記号は省略可能です。
pipe-name: 有効なパイプ名を指定します。有効なパイプ名は、円記号で区切られた識別子を含む文字列です。最初の識別子は パイプである必要があります。各識別子は、2 つの円記号で区切る必要があります。

解説

サーバーは名前付きパイプのインスタンスを作成し、そのインスタンスを任意のクライアントで使用できます。クライアントが接続しようとすると、既存のインスタンスがそのクライアントに関連付けられます。別のクライアントが接続する前に、サーバーは名前付きパイプの別のインスタンスを作成する必要があります。新しいインスタンスが作成される前にクライアントがサーバーにバインドしようとすると、バインド呼び出し 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.
}

ncacn_np属性

パラメーター

解説

例

関連項目

フィードバック

フィードバック

その他のリソース