RpcObjectSetType-Funktion (rpcdce.h)

  • Artikel

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
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_INVALID_OBJECT
 Das Objekt ist ungültig.
RPC_S_ALREADY_REGISTERED
 Das Objekt ist bereits registriert.
RPC_S_OUT_OF_MEMORY
 Das System hat nicht genügend Arbeitsspeicher.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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

Weitere Informationen

Registrieren von Schnittstellen

RpcServerRegisterIf