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]")

関連項目

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

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf