RPC_ENDPOINT_TEMPLATEA構造体 (rpcdce.h)

RPC_ENDPOINT_TEMPLATE 構造体は、プロトコル シーケンスと名前を含む RPC インターフェイス グループ サーバー エンドポイントのプロパティを指定します。

構文

typedef struct {
  unsigned long Version;
  RPC_CSTR      ProtSeq;
  RPC_CSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATEA, *PRPC_ENDPOINT_TEMPLATEA;

メンバーズ

Version

このフィールドは予約済みであり、0 に設定する必要があります。

ProtSeq

RPC ランタイム ライブラリに登録するプロトコル シーケンスの文字列識別子へのポインター。 ncalrpc、ncacn_ip_tcp、およびncacn_np のみがサポートされます。 この値は NULLすることはできません。

Endpoint

Protseq パラメーターで指定されたプロトコル シーケンスのバインディングの作成に使用するエンドポイント アドレス情報へのオプションのポインター。 動的エンドポイント 使用する NULL を指定します。

SecurityDescriptor

セキュリティ サブシステムに指定された省略可能なパラメーターへのポインター。 ncacn_np および ncalrpc プロトコル シーケンスにのみ使用されます。 他のすべてのプロトコル シーケンスでは、このパラメーターは無視されます。 サーバーをセキュリティで保護するためにエンドポイントでセキュリティ記述子を使用することはお勧めしません。

Backlog

ncacn_ip_tcp プロトコル シーケンスのバックログ キューの長さ。 他のすべてのプロトコル シーケンスでは、このパラメーターは無視されます。 既定値を指定するには、RPC_C_PROTSEQ_MAX_REQS_DEFAULT を使用します。 詳細については、「解説」を参照してください。

備考

アプリケーションによって バックログで指定される値は、ヒントにすぎません。 RPC ランタイムまたは Windows ソケット プロバイダーによって値がオーバーライドされる場合があります。 たとえば、Windows XP または Windows 2000 Professional では、値は 5 に制限されます。 5 より大きい値は無視され、代わりに 5 が使用されます。 Windows Server 2003 および Windows 2000 Server では、この値が使用されます。

アプリケーションは、バックログで適切な値 渡すように注意する必要があります。 サーバー、Advanced Server、または Datacenter Server の値が大きいと、大量の非ページ プール メモリが使用される可能性があります。 値が小さすぎると、バックログ キューが使い果たされた場合に、サーバーから TCP RST によって TCP SYN パケットが満たされる可能性があるため、好ましくない場合もあります。

アプリケーション開発者は、バックログの適切な値を決定する際に、メモリフットプリントとスケーラビリティ要件 バランスを取る必要があります。

手記

rpcdce.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてRPC_ENDPOINT_TEMPLATEを定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8 [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2012 [デスクトップ アプリのみ]
ヘッダー	rpcdce.h (Rpc.h を含む)

関連項目

RpcServerInqBindings の