RpcBindingFromStringBindingA-Funktion (rpcdce.h)

  • Artikel

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

Syntax

RPC_STATUS RpcBindingFromStringBindingA(
  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.

Hinweis

Der rpcdce.h-Header definiert RpcBindingFromStringBinding als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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