RpcBindingFromStringBindingW-Funktion (rpcdce.h)
Die RpcBindingFromStringBinding--Funktion gibt ein Bindungshandle aus einer Zeichenfolgendarstellung eines Bindungshandle zurück.
Syntax
RPC_STATUS RpcBindingFromStringBindingW(
RPC_WSTR StringBinding,
RPC_BINDING_HANDLE *Binding
);
Parameter
StringBinding
Zeiger auf eine Zeichenfolgendarstellung eines Bindungshandle.
Binding
Gibt einen Zeiger auf das Serverbindungshandle zurück.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Zeichenfolgenbindung ist ungültig. |
|
Die Protokollsequenz wird auf diesem Host nicht unterstützt. |
|
Die Protokollsequenz ist ungültig. |
|
Das Endpunktformat ist ungültig. |
|
Zeichenfolge zu lang. |
|
Die Netzwerkadresse ist ungültig. |
|
Das Argument war ungültig. |
|
Der Netzwerkadressenfamilienbezeichner ist ungültig. |
Bemerkungen
Die RpcBindingFromStringBinding--Funktion erstellt ein Serverbindungshandle aus einer Zeichenfolgendarstellung eines Bindungshandle. Der parameter StringBinding muss kein Objekt UUID-enthalten. In diesem Fall enthält die zurückgegebene Bindung eine nil UUID. Wenn der bereitgestellte StringBinding Parameter kein Endpunktfeld enthält, ist der zurückgegebene Binding Parameter ein teilweise gebundenes Bindungshandle. Wenn der bereitgestellte StringBinding Parameter ein Endpunktfeld enthält, wird der Endpunkt als bekannter Endpunkt betrachtet. Wenn der bereitgestellte StringBinding Parameter kein Hostadressenfeld enthält, verweist der zurückgegebene Binding Parameter auf den lokalen Host.
Eine Anwendung erstellt eine Zeichenfolgenbindung durch Aufrufen der RpcStringBindingCompose-Funktion oder durch Bereitstellen einer Zeichenzeichenfolgenkonstante. Die Erstellung einer Zeichenfolgenbindung durch diese Methode umfasst keinen Kontakt mit dem Server. Erfolg oder Fehler der API deuten nicht auf die Serververfügbarkeit hin.
Wenn eine Anwendung mit dem Parameter Binding fertig ist, sollte die Anwendung die RpcBindingFree--Funktion aufrufen, um den vom Bindungshandle verwendeten Speicher freizugeben.
Anmerkung
Der header rpcdce.h definiert RpcBindingFromStringBinding als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | rpcdce.h (include Rpc.h) |
| Library | Rpcrt4.lib |
| DLL- | Rpcrt4.dll |