RpcBindingFromStringBinding-Funktion (rpcdce.h)

Die RpcBindingFromStringBinding-Funktion gibt ein Bindungshandle aus einer Zeichenfolgendarstellung eines Bindungshandles zurück.

Syntax

RPC_STATUS RpcBindingFromStringBinding(
  RPC_CSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Parameter

StringBinding

Zeiger auf eine Zeichenfolgendarstellung eines Bindungshandles.

Binding

Gibt einen Zeiger auf das Serverbindungshandle zurück.

Rückgabewert

Hinweise

Die RpcBindingFromStringBinding-Funktion erstellt ein Serverbindungshandle aus einer Zeichenfolgendarstellung eines Bindungshandles. Der StringBinding-Parameter muss keine Objekt-UUID enthalten. In diesem Fall enthält die zurückgegebene Bindung eine Null-UUID. Wenn der angegebene StringBinding-Parameter kein Endpunktfeld enthält, ist der zurückgegebene Bindungsparameter ein teilweise gebundenes Bindungshandle. Wenn der angegebene StringBinding-Parameter ein Endpunktfeld enthält, wird der Endpunkt als bekannter Endpunkt betrachtet. Wenn der angegebene StringBinding-Parameter kein Hostadressenfeld enthält, verweist der zurückgegebene Bindungsparameter auf den lokalen Host.

Eine Anwendung erstellt eine Zeichenfolgenbindung, indem sie die RpcStringBindingCompose-Funktion aufruft oder eine Zeichenfolgenkonstante bereitstellt. Die Erstellung einer Zeichenfolgenbindung durch diese Methode beinhaltet keinen Kontakt mit dem Server. Erfolg oder Fehler der API weisen nicht auf die Verfügbarkeit des Servers hin.

Wenn eine Anwendung den Binding-Parameter verwendet, sollte die Anwendung die RpcBindingFree-Funktion aufrufen, um den vom Bindungshandle verwendeten Arbeitsspeicher freizugeben.

Anforderungen

Weitere Informationen

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose