RpcObjectSetType 関数 (rpcdce.h)

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

構文

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

パラメーター

ObjUuid

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

TypeUuid

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

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

戻り値

値	意味
RPC_S_OK	呼び出しは成功しました。
RPC_S_INVALID_OBJECT	オブジェクトが無効です。
RPC_S_ALREADY_REGISTERED	オブジェクトは既に登録されています。
RPC_S_OUT_OF_MEMORY	システムがメモリ不足です。

 

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

 

注釈

サーバー アプリケーションは 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 を自動的に割り当てます。

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

要件

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

こちらもご覧ください

インターフェイスの登録

RpcServerRegisterIf