RPC_INTERFACE_TEMPLATEA構造体 (rpcdce.h)

[アーティクル]
11/20/2024

RPC_INTERFACE_TEMPLATE 構造体は、RPC インターフェイスグループサーバーインターフェイスを定義します。

構文

typedef struct {
  unsigned long      Version;
  RPC_IF_HANDLE      IfSpec;
  UUID               *MgrTypeUuid;
  RPC_MGR_EPV        *MgrEpv;
  unsigned int       Flags;
  unsigned int       MaxCalls;
  unsigned int       MaxRpcSize;
  RPC_IF_CALLBACK_FN *IfCallback;
  UUID_VECTOR        *UuidVector;
  RPC_CSTR           Annotation;
  void               *SecurityDescriptor;
} RPC_INTERFACE_TEMPLATEA, *PRPC_INTERFACE_TEMPLATEA;

メンバーズ

Version

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

IfSpec

登録するインターフェイスを定義する MIDL によって生成される構造体。

MgrTypeUuid

MgrEpvに関連付ける UUID へのポインター。 NULL または nil UUID を、IfSpec を nil UUIDに登録します。

MgrEpv

マネージャールーチンのエントリポイントベクトル (EPV) を含む RPC_MGR_EPV 構造体へのポインター。 NULL場合は、MIDL で生成された既定の EPV が使用されます。

Flags

フラグ。フラグ値の一覧については、「インターフェイス登録フラグの」を参照してください。インターフェイスグループインターフェイスは、常に自動リッスンとして扱われます。

MaxCalls

サーバーがこのインターフェイスで受け入れることができる同時リモートプロシージャコール要求の最大数。 RPC ランタイムライブラリは、maxCallsで指定された呼び出しの数よりも多くの同時呼び出し要求がサーバーで許可されないように、ベストエフォートします。ただし、実際の数は MaxCalls より大きくすることができ、プロトコルシーケンスごとに異なる場合があります。

他のインターフェイスでの呼び出しは、RpcServerListenで指定されたプロセス全体 MaxCalls パラメーター値によって制御されます。

同時呼び出しの数が問題にならない場合は、RPC_C_LISTEN_MAX_CALLS_DEFAULTを使用して既定値を指定することで、サーバー側のパフォーマンスを若干向上させることができます。これにより、RPC ランタイム環境で不要な制限が適用されなくなります。

MaxRpcSize

受信データブロックの最大サイズ (バイト単位)。 MaxRpcSize 、悪意のあるサービス拒否攻撃を防ぐために使用できます。リモートプロシージャコールのデータブロックが MaxRpcSizeより大きい場合、RPC ランタイムライブラリは呼び出しを拒否し、RPC_S_ACCESS_DENIED エラーをクライアントに送信します。 MaxRpcSize で値 (unsigned int) –1 指定すると、受信データブロックのサイズの制限が削除されます。このパラメーターは、ncalrpc プロトコル経由で行われた呼び出しには影響しません。

IfCallback

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN セキュリティコールバック関数へのポインター。コールバックがない場合は NULL をします。登録されたインターフェイスごとに異なるコールバック関数を持つことができます。

UuidVector

RPC エンドポイントマッパーに登録サーバーによって提供される UUID オブジェクトのベクトルへのポインター。サーバーアプリケーションはこのベクトルを構築します。 NULL は、登録する UUID オブジェクトがないことを示します。

Annotation

ローカルエンドポイントマップデータベースに追加された各製品間要素に適用される文字列コメントへのポインター。文字列は、null 終端文字を含め、最大 64 文字まで指定できます。注釈文字列がない場合は、null 値または null で終わる文字列 ("\0") を指定します。

注釈文字列は、情報のためだけにアプリケーションによって使用されます。 RPC は、クライアントが通信するサーバーインスタンスを特定したり、エンドポイントマップデータベース内の要素を列挙したりするために、この文字列を使用しません。

SecurityDescriptor

インターフェイスにアクセスする権限を持つクライアントを記述するオプションのセキュリティ記述子。

備考

インターフェイスを登録するために、サーバーは次の情報を提供します。

インターフェイス仕様インターフェイス仕様は、MIDL コンパイラによって生成されるデータ構造です。
マネージャー UUID とマネージャー EPV マネージャーの種類は UUID し、マネージャー EPV は、サーバーがクライアントからリモートプロシージャコール要求を受信したときに実行されるマネージャールーチンを決定します。サーバーによって提供されるインターフェイスの実装ごとに、個別のマネージャー EPV を登録する必要があります。非 nil のマネージャー型 UUIDを指定する場合、サーバーは rpcObjectSetType 呼び出して、この nil 以外の型のオブジェクトを登録する必要があることに注意してください。

すべてのインターフェイスグループインターフェイスは、自動リッスン扱われます。ランタイムは、インターフェイスグループがアクティブになるとすぐに呼び出しのリッスンを開始します。 RpcServerListen と RpcMgmtStopServerListening 呼び出しは、インターフェイスに影響を与えません。また、IfSpec が NULLに設定された rpcServerUnregisterIf 呼び出。

IfCallback でセキュリティコールバック関数を指定すると、サーバーアプリケーションは個々のクライアントベースでインターフェイスへのアクセスを制限できます。つまり、既定では、セキュリティは省略可能です。サーバーランタイムは、サーバーが RpcServerRegisterAuthInfo呼び出した場合でも、セキュリティで保護されていない呼び出しをディスパッチします。サーバーが認証されたクライアントのみを受け入れる場合、インターフェイスコールバック関数は、RpcBindingInqAuthClient 、RpcGetAuthorizationContextForClient、または RpcServerInqCallAttributes を呼び出してセキュリティレベルを取得するか、RpcImpersonateClientを使用してクライアント偽装を試みる必要があります。認証されていない呼び出しを拒否するために、Flags で RPC_IF_ALLOW_SECURE_ONLY フラグを指定することもできます。

サーバーアプリケーションが ifCallbackでインターフェイスのセキュリティコールバック関数指定すると、RPC ランタイムはそのインターフェイスに対する認証情報なしで呼び出しを自動的に拒否します。さらに、ランタイムは、各クライアントが使用したインターフェイスを記録します。クライアントが現在の通信セッション中に使用していないインターフェイスに RPC を作成すると、RPC ランタイムライブラリはインターフェイスのセキュリティコールバック関数を呼び出します。 Flags で RPC_IF_ALLOW_CALLBACKS_WITH_NO_AUTH を指定すると、認証されていないクライアントが自動的に拒否されなくなります。 NULL セキュリティセッションの呼び出しは、匿名クライアントから送信された場合でも、認証情報を持つことができます。したがって、匿名クライアントが接続するのを防ぐには、コールバックだけでは十分ではありません。セキュリティコールバック関数がそのことを確認する必要があるか、RPC_IF_ALLOW_SECURE_ONLY フラグを使用する必要があります。 RPC_IF_ALLOW_SECURE_ONLYは、Windows XP 以降のバージョンの Windows でのみ null セッション呼び出しを拒否します。

コールバック関数のシグネチャについては、RPC_IF_CALLBACK_FNを参照してください。

IfCallback のコールバック関数は、クライアントがこのインターフェイスでメソッドを呼び出す RPC_S_OK を返す必要があります。その他のリターンコードを使用すると、クライアントは例外 RPC_S_ACCESS_DENIEDを受け取ります。

場合によっては、RPC ランタイムは、クライアントごとに、インターフェイスごとに複数回セキュリティコールバック関数を呼び出す場合があります。コールバック関数は、この可能性を処理できる必要があります。

手記

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

必要条件

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

次の方法で共有

RPC_INTERFACE_TEMPLATEA構造体 (rpcdce.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース