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

Wert Bedeutung
RPC_S_OK
Der Aufruf war erfolgreich.
RPC_S_INVALID_STRING_BINDING
Die Zeichenfolgenbindung ist ungültig.
RPC_S_PROTSEQ_NOT_SUPPORTED
Die Protokollsequenz wird auf diesem Host nicht unterstützt.
RPC_S_INVALID_RPC_PROTSEQ
Die Protokollsequenz ist ungültig.
RPC_S_INVALID_ENDPOINT_FORMAT
Das Endpunktformat ist ungültig.
RPC_S_STRING_TOO_LONG
Die Zeichenfolge ist zu lang.
RPC_S_INVALID_NET_ADDR
Die Netzwerkadresse ist ungültig.
RPC_S_INVALID_ARG
Das Argument war ungültig.
RPC_S_INVALID_NAF_ID
Der Bezeichner der Netzwerkadressenfamilie ist ungültig.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile rpcdce.h (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose