endpoint 属性
[endpoint] 属性は、インターフェイスのサーバーが呼び出しをリッスンする既知のポートまたはポート (通信エンドポイント) を指定します。
endpoint("protocol-sequence:[endpoint-port]" [ , ...] )
パラメーター
-
protocol-sequence
-
RPC プロトコル ("ncacn" など)、トランスポート プロトコル ("tcp"など)、およびネットワーク プロトコル ("ip" など) の有効な組み合わせを表す文字列を指定します。 有効なプロトコル シーケンスの一覧については、「 プロトコル シーケンス定数」を参照してください。
-
endpoint-port
-
指定したプロトコル ファミリのエンドポイント指定を表す文字列を指定します。 ポート文字列の構文は、各プロトコル シーケンスに固有です。
解説
[endpoint] 属性は、TCP/IP 接続指向プロトコル、NetBIOS 接続指向プロトコル、名前付きパイプ接続指向プロトコルなどのトランスポート ファミリを指定します。 [endpoint] 属性の使用は、エンドポイントを追加するための他の方法と一致し、エンドポイントに追加または特別なサービスを提供しません。API を呼び出すためのショートカットを提供するだけです。
Note
でエンドポイントを指定します。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]")
関連項目