RpcObjectSetType 函式 (rpcdce.h)

RpcObjectSetType 函式會指派對象的類型。

語法

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

參數

ObjUuid

物件 UUID 的指標，以與 TypeUuid 參數中的類型 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。 包含一個介面實作的伺服器應用程式， (一個管理員進入點向量 [EPV]) 不需要呼叫 RpcObjectSetType ，前提是伺服器向 nil 類型 UUID 註冊介面， (請參閱 RpcServerRegisterIf) 底下。

伺服器應用程式，其中包含多個介面實作 (多個管理員 EPV—也就是說，多個類型 UUID) 針對伺服器支援的每個不同物件 UUID/非 nil 類型 UUID 關聯呼叫 RpcObjectSetType 一次。 將每個物件與 UUID 類型建立關聯，會告訴 RPC 運行時間連結庫，當伺服器收到非 nil 物件 UUID 的遠端過程調用時，) 使用哪個管理員 EPV (介面實作。

RPC 執行時間連結庫可讓應用程式為無限數目的物件設定類型。 若要移除物件 UUID 與其類型 UUID 之間的關聯， (呼叫 RpcObjectSetType) ，伺服器會再次呼叫 RpcObjectSetType ，並指定 TypeUuid 參數的 Null 值或 nil UUID。 這會將物件 UUID/類型 UUID 關聯重設為物件 UUID/nil-type UUID 的默認關聯。 伺服器無法將類型指派給 nil 物件 UUID。 RPC 執行時間連結庫會自動指派 nil 物件 UUID nil 類型 UUID。

如需詳細資訊，請參閱 註冊介面。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	rpcdce.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll

另請參閱

註冊介面

RpcServerRegisterIf