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

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

Weitere Informationen

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree