RPC_BINDING_HANDLE_TEMPLATE_V1_W-Struktur (rpcdce.h)

Artikel
03/04/2024

Die RPC_BINDING_HANDLE_TEMPLATE_V1-Struktur enthält die grundlegenden Optionen zum Erstellen eines RPC-Bindungshandles.

Syntax

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_W {
  unsigned long  Version;
  unsigned long  Flags;
  unsigned long  ProtocolSequence;
  unsigned short *NetworkAddress;
  unsigned short *StringEndpoint;
  union {
    unsigned short *Reserved;
  } u1;
  UUID           ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_W, *PRPC_BINDING_HANDLE_TEMPLATE_V1_W;

Member

Version

Die Version dieser Struktur. Für RPC_BINDING_HANDLE_TEMPLATE_V1 muss dies auf 1 festgelegt werden.

Flags

Flagwerte, die bestimmte Eigenschaften der RPC-Vorlage beschreiben.

Wert	Bedeutung
RPC_BHT_OBJECT_UUID_VALID	Das ObjectUuid-Element enthält einen gültigen Wert. Wenn dieses Flag nicht festgelegt ist, enthält das ObjectUuid-Element keine gültige UUID.

ProtocolSequence

Ein Diesem Bindungshandle zugeordnetes Protokollsequenzzeichenfolgenliteral . Dieses Argument einen der folgenden Werte annehmen.

ncalrpc : Gibt den lokalen RPC an. ncacn_ip_tcp : Gibt RPC über TCP/IP an. ncacn_np : Gibt RPC über Named Pipes an. ncacn_http : Gibt RPC über HTTP an.

NetworkAddress

Zeiger auf eine Zeichenfolgendarstellung der Netzwerkadresse, an die gebunden werden soll.

StringEndpoint

Zeiger auf eine Zeichenfolgendarstellung des Endpunkts, an den gebunden werden soll. Wenn ein dynamischer Endpunkt verwendet wird, legen Sie diesen Member auf NULL fest. Nachdem der Endpunkt aufgelöst wurde, verwenden Sie RpcBindingToStringBinding , um ihn abzurufen.

u1

u1.Reserved

Reserviert. Dieser Member muss auf NULL festgelegt werden.

ObjectUuid

Die UUID des Remoteobjekts. Die Semantik für diese UUID ist identisch mit der für eine Zeichenfolgenbindung. Nachdem das Bindungshandle erstellt wurde, rufen Sie RpcBindingSetObject auf, um die UUID nach Bedarf zu ändern.

Hinweise

Schnelle Bindungshandles unterscheiden sich geringfügig von "klassischen" Bindungshandles in der Art und Weise, wie sie bei Aufrufen von RpcBindingReset behandelt werden. RpcBindingReset ist ein no-op-Aufruf für handles für statische schnelle Bindung. Bei klassischen Bindungshandles konvertiert RpcBindingReset jedoch ein statisches Bindungshandle in ein dynamisches, um abwärtskompatibel zu bleiben.

Die folgende Tabelle veranschaulicht das Verhalten statischer und dynamischer Bindungshandles in Bezug auf RpcBindingReset und RpcEpResolveBinding.

Endpunkttyp	statischen		Dynamisch
Bindungshandletyp	Schnell	Klassisch	Schnell	Klassisch
RpcBindingReset	No-op	Konvertiert in dynamisch	Entfernt den aufgelösten Endpunkt, wenn ein vorhanden ist.	Entfernt den aufgelösten Endpunkt, wenn ein vorhanden ist.
RpcEpResolveBinding	No-op	No-op	Löst den Endpunkt auf, wenn er zuvor nicht aufgelöst wurde.	Löst den Endpunkt auf, wenn er zuvor nicht aufgelöst wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	rpcdce.h (rpc.h einschließen)

Weitere Informationen

RPC_BINDING_HANDLE

RpcBindingBind

RpcBindingErstellen

Freigeben über