RpcObjectSetType 関数 (rpcdce.h)

RpcObjectSetType 関数は、オブジェクトの型を割り当てます。

構文

RPC_STATUS RpcObjectSetType(
  UUID *ObjUuid,
  UUID *TypeUuid
);

パラメーター

ObjUuid

TypeUuid パラメーターの UUID 型に関連付けるオブジェクト UUID へのポインター。

TypeUuid

ObjUuid パラメーターの UUID 型へのポインター。

NULL または nil UUID のパラメーター値を指定して、オブジェクトの種類をオブジェクト UUID/nil 型 UUID の既定の関連付けにリセットします。

戻り値

注釈

サーバー アプリケーションは RpcObjectSetType を呼び出して、オブジェクト UUID に型 UUID を割り当てます。 既定では、RPC ランタイム ライブラリは、nil 型 UUID を持つすべてのオブジェクト UUID を自動的に割り当てます。 インターフェイスの 1 つの実装を含むサーバー アプリケーション (1 つのマネージャー エントリ ポイント ベクター [EPV]) は、サーバーが nil 型 UUID でインターフェイスを登録した場合に RpcObjectSetType を呼び出す必要はありません (「 RpcServerRegisterIf」を参照)。

インターフェイスの複数の実装を含むサーバー アプリケーション (複数のマネージャー EPV 、つまり複数の種類の UUID) は、サーバーがサポートする異なるオブジェクト UUID/非 nil 型 UUID の関連付けごとに RpcObjectSetType を 1 回呼び出します。 各オブジェクトを UUID 型に関連付けると、サーバーが nil 以外のオブジェクト UUID のリモート プロシージャ コールを受信したときに使用するマネージャー EPV (インターフェイス実装) が RPC ランタイム ライブラリに指示されます。

RPC ランタイム ライブラリを使用すると、アプリケーションはオブジェクトの数に制限なく型を設定できます。 オブジェクト UUID とその型 UUID ( RpcObjectSetType を呼び出して確立) の間の関連付けを削除するために、サーバーはもう一度 RpcObjectSetType を呼び出し、 TypeUuid パラメーターに null 値または nil UUID を指定します。 これにより、オブジェクト UUID/型 UUID の関連付けが、オブジェクト UUID/nil 型 UUID の既定の関連付けにリセットされます。 サーバーは、nil オブジェクト UUID に型を割り当てることができません。 RPC ランタイム ライブラリは、nil オブジェクト UUID に nil 型 UUID を自動的に割り当てます。

詳細については、「 インターフェイスの登録」を参照してください。

要件

こちらもご覧ください

インターフェイスの登録

RpcServerRegisterIf