RpcObjectSetType-Funktion (rpcdce.h)
Die RpcObjectSetType-Funktion weist den Typ eines Objekts zu.
Syntax
RPC_STATUS RpcObjectSetType(
UUID *ObjUuid,
UUID *TypeUuid
);
Parameter
ObjUuid
Zeiger auf eine Objekt-UUID, die dem Typ UUID im TypeUuid-Parameter zugeordnet werden soll.
TypeUuid
Zeiger auf den Typ UUID des ObjUuid-Parameters .
Geben Sie einen Parameterwert von NULL oder eine Null-UUID an, um den Objekttyp auf die Standardzuordnung der Objekt-UUID/nil-Type-UUID zurückzusetzen.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Das Objekt ist ungültig. |
|
Das Objekt ist bereits registriert. |
|
Das System hat nicht genügend Arbeitsspeicher. |
Hinweise
Eine Serveranwendung ruft RpcObjectSetType auf, um einer Objekt-UUID eine Typ-UUID zuzuweisen. Standardmäßig weist die RPC-Laufzeitbibliothek automatisch alle Objekt-UUIDs mit der UUID vom Typ nil zu. Eine Serveranwendung, die eine Implementierung einer Schnittstelle enthält (ein Manager-Einstiegspunktvektor [EPV]), muss RpcObjectSetType nicht aufrufen, vorausgesetzt, der Server hat die Schnittstelle mit der UUID vom Typ nil registriert (siehe unter RpcServerRegisterIf).
Eine Serveranwendung, die mehrere Implementierungen einer Schnittstelle enthält (mehrere Manager-EPVs– d. h. mehrere Typ-UUIDs), ruft RpcObjectSetType einmal für jede vom Server unterstützte UUID/nicht-nil-Typzuordnung des Typs RpcObjectSetType auf. Das Zuordnen jedes Objekts zu einer Typ-UUID teilt der RPC-Laufzeitbibliothek mit, welche Manager-EPV (Schnittstellenimplementierung) verwendet werden soll, wenn der Server einen Remoteprozeduraufruf für eine Nicht-Nil-Objekt-UUID empfängt.
Die RPC-Laufzeitbibliothek ermöglicht es einer Anwendung, den Typ für eine unbegrenzte Anzahl von Objekten festzulegen. Um die Zuordnung zwischen einer Objekt-UUID und ihrem Typ UUID (durch Aufrufen von RpcObjectSetType eingerichtet) zu entfernen, ruft ein Server rpcObjectSetType erneut auf und gibt einen NULL-Wert oder eine null-UUID für den TypeUuid-Parameter an. Dadurch wird die Objekt-UUID/Typ-UUID-Zuordnung auf die Standardzuordnung der Objekt-UUID/nil-Typ-UUID zurückgesetzt. Ein Server kann der UUID des Nil-Objekts keinen Typ zuweisen. Die RPC-Laufzeitbibliothek weist der UUID des Nil-Objekts automatisch eine UUID vom Typ Nil zu.
Ausführliche Informationen finden Sie unter Registrieren von Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcdce.h (include Rpc.h) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |