RpcStringBindingParse-Funktion (rpcdce.h)
Die RpcStringBindingParse-Funktion gibt den UUID-Teil des Objekts und die Adressteile einer Zeichenfolgenbindung als separate Zeichenfolgen zurück. Eine Anwendung ruft RpcStringBindingParse auf, um eine Zeichenfolgendarstellung eines Bindungshandles in die zugehörigen Komponentenfelder zu analysieren. Die RpcStringBindingParse-Funktion gibt den UUID-Teil des Objekts und die Adressteile einer Zeichenfolgenbindung als separate Zeichenfolgen zurück.
Syntax
RPC_STATUS RpcStringBindingParse(
RPC_CSTR StringBinding,
RPC_CSTR *ObjUuid,
RPC_CSTR *Protseq,
RPC_CSTR *NetworkAddr,
RPC_CSTR *Endpoint,
RPC_CSTR *NetworkOptions
);
Parameter
StringBinding
Zeiger auf eine NULL-beendete Zeichenfolgendarstellung einer Bindung.
ObjUuid
Gibt einen Zeiger auf einen Zeiger auf eine null-endende Zeichenfolgendarstellung einer Objekt-UUID zurück.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcStringBindingParse den ObjectUuid-Parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree nicht auf.
Protseq
Gibt einen Zeiger auf einen Zeiger auf eine null-endende Zeichenfolgendarstellung einer Protokollsequenz zurück. Eine Liste der von Microsoft RPC unterstützten Protokollsequenzen finden Sie unter Zeichenfolgenbindung.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcStringBindingParse den ProtSeq-Parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree nicht auf.
NetworkAddr
Gibt einen Zeiger auf einen Zeiger auf eine NULL-endende Zeichenfolgendarstellung einer Netzwerkadresse zurück. Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcStringBindingParse den Parameter NetworkAddr zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree nicht auf.
Endpoint
Gibt einen Zeiger auf einen Zeiger auf eine NULL-endende Zeichenfolgendarstellung eines Endpunkts zurück. Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcStringBindingParse den EndPoint-Parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree nicht auf.
NetworkOptions
Gibt einen Zeiger auf einen Zeiger auf eine NULL-endende Zeichenfolgendarstellung von Netzwerkoptionen zurück.
Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcStringBindingParse den Parameter NetworkOptions zurückgibt . In diesem Fall ruft die Anwendung RpcStringFree nicht auf.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Zeichenfolgenbindung ist ungültig. |
Hinweise
Eine Anwendung ruft die RpcStringBindingParse-Routine auf, um eine Zeichenfolgendarstellung eines Bindungshandles in die zugehörigen Komponentenfelder zu analysieren.
Die RPC-Laufzeitbibliothek ordnet arbeitsspeicher für jede zurückgegebene Komponentenzeichenfolge zu. Die Anwendung ist dafür verantwortlich , RpcStringFree einmal für jede zurückgegebene Zeichenfolge aufzurufen, um die Zuordnung des Arbeitsspeichers für diese Zeichenfolge aufzugeben.
Wenn ein Feld des StringBinding-Parameters leer ist, gibt RpcStringBindingParse eine leere Zeichenfolge (\0) im entsprechenden Ausgabeparameter zurück.
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 (rpc.h einschließen) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |