endpoint 属性

エンドポイント [ 属性 ] は、インターフェイスのサーバーが呼び出しをリッスンする既知のポートまたはポート (通信エンドポイント) を指定します。

endpoint("protocol-sequence:[endpoint-port]" [ , ...] )

パラメーター

protocol-sequence

RPC プロトコル ("ncacn"など)、トランスポート プロトコル ("tcp"など)、およびネットワーク プロトコル ("ip" など) の有効な組み合わせを表す文字列を指定します。 有効なプロトコル シーケンスの一覧については、「プロトコル シーケンス定数 」を参照してください

endpoint-port

指定したプロトコル ファミリのエンドポイント指定を表す文字列を指定します。 ポート文字列の構文は、各プロトコル シーケンスに固有です。

解説

エンドポイント [ 属性 ] は、TCP/IP 接続指向プロトコル、NetBIOS 接続指向プロトコル、名前付きパイプ接続指向プロトコルなどのトランスポート ファミリを指定します。 エンドポイント属性 [ の使用 ] は、エンドポイントを追加する他のメソッドと一貫性があり、エンドポイントに追加または特別なサービスを提供するのではなく、API を呼び出すショートカットを提供します。

注意

でのエンドポイントの指定。IDL インターフェイス定義では、指定されたエンドポイントへのインターフェイスへのアクセスは制限されません。 エンドポイントを に追加します。IDL インターフェイス定義を使用すると、そのプロセス内の任意のエンドポイントを介してインターフェイスを呼び出し、そのプロセス内の他のインターフェイスを呼び出すエンドポイントを使用できます。

プロトコル シーケンス値は、 エンドポイント ポート の有効な値 を決定します。 MIDL コンパイラは、エンドポイント ポート エントリの一般的 な構文のみをチェック します。 ポート指定エラーは、実行時ライブラリによって報告されます。 各プロトコル シーケンスで使用できる値の詳細については、「プロトコル シーケンス定数 」を参照してください

DCE で指定された次のプロトコル シーケンスは、Microsoft RPC で提供される MIDL コンパイラではサポートされていません: ncacn _ osi _ dna および ncadg _ dds

エンドポイントで円記号文字を正しく引用符で囲む必要があります。 このエラーは通常、エンドポイントが名前付きパイプの場合に発生します。

IDL ファイルで指定されたエンドポイント情報は、RPC ランタイム関数 RpcServerUseProtseqIf および RpcServerUseAllProtseqsIfによって使用されます。

endpoint("ncacn_np:[\\pipe\\rainier]") 

endpoint("ncacn_ip_tcp:[1044]", "ncacn_np:[\\pipe\\shasta]")

関連項目

インターフェイス定義 (IDL) ファイル

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf