RpcServerUseAllProtseqsIf 関数 (rpcdce.h)

[アーティクル]
03/01/2024

RpcServerUseAllProtseqsIf 関数は、リモートプロシージャ呼び出しを受信するために、インターフェイス仕様で指定されたすべてのプロトコルシーケンスとエンドポイントを使用するように RPC ランタイムライブラリに指示します。

構文

RPC_STATUS RpcServerUseAllProtseqsIf(
  unsigned int  MaxCalls,
  RPC_IF_HANDLE IfSpec,
  void          *SecurityDescriptor
);

パラメーター

MaxCalls

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

IfSpec

バインディングハンドルの作成に使用するプロトコルシーケンスと対応するエンドポイント情報を含むインターフェイス。

SecurityDescriptor

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

戻り値

値	意味
RPC_S_OK	呼び出しは成功しました。
RPC_S_NO_PROTSEQS	サポートされているプロトコルシーケンスはありません。
RPC_S_INVALID_ENDPOINT_FORMAT	エンドポイントの形式。
RPC_S_OUT_OF_MEMORY	システムがメモリ不足です。
RPC_S_DUPLICATE_ENDPOINT	エンドポイントが重複しています。
RPC_S_INVALID_SECURITY_DESC	セキュリティ記述子が無効です。
RPC_S_INVALID_RPC_PROTSEQ	RPC プロトコルシーケンスが無効です。

メモ有効なエラーコードの一覧については、「 RPC 戻り値」を参照してください。

注釈

メモサポートされているすべてのプロトコルシーケンスでリッスンすることは推奨されません。これは、サーバーが非メインストリームプロトコルシーケンスを含むすべてのプロトコルシーケンスでリッスンするためです。サーバーはメインストリームプロトコルシーケンスでのみリッスンすることをお勧めします。

サーバーアプリケーションは RpcServerUseAllProtseqsIf を呼び出して、IDL ファイルで提供されるすべてのプロトコルシーケンスと関連付けられたエンドポイントアドレス情報を RPC ランタイムライブラリに登録します。 RPC でサポートされるプロトコルシーケンスの一覧については、「文字列バインディング」を参照してください。

リモートプロシージャコール要求を受信するには、サーバーが RPC ランタイムライブラリに少なくとも 1 つのプロトコルシーケンスを登録する必要があります。サーバーによって登録されたプロトコルシーケンスごとに、RPC ランタイムライブラリによって、サーバーがリモートプロシージャコール要求を受信する 1 つ以上のエンドポイントが作成されます。 RPC ランタイムライブラリは、プロトコルシーケンスごとに異なるエンドポイントを作成します。

メモRpcServerUseAllProtseqsIf 関数を使用しても、サーバーは次のプロトコルシーケンスでリッスンしません。

メモこれらのプロトコルシーケンスのいずれかをリッスンするには、各シーケンスを個別に選択する必要があります。

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

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

選択的バインディングを使用するようにコンピューターが構成されている場合、正常な戻り値は、サーバーがコンピューター上にあるすべてのネットワークインターフェイスのエンドポイントを作成したことを保証しません。 RPC ランタイムは、選択的バインディング設定によっては、一部のネットワークインターフェイスでリッスンしない場合があります。さらに、インターフェイスが DHCP を使用して IP アドレスをまだ受信していない場合、RPC サーバーは DHCP アドレスが割り当てられるまでネットワークインターフェイスでリッスンしません。正常な戻り値は、サーバーが少なくとも 1 つのネットワークインターフェイスでリッスンしていることを意味します。 RpcServerInqBindings 関数の呼び出しを使用して、リモートプロシージャ呼び出しを受信できるバインディングハンドルの完全な一覧を取得できます。

詳細については、「サーバー側バインド」を参照してください。 IDL ファイルで指定された選択したプロトコルシーケンスを登録するために、サーバーは RpcServerUseProtseqIf を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	rpcdce.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll