RpcStringBindingComposeA-Funktion (rpcdce.h)

Die RpcStringBindingCompose--Funktion erstellt ein Zeichenfolgenbindungshandle.

Syntax

RPC_STATUS RpcStringBindingComposeA(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Parameter

ObjUuid

Zeiger auf eine NULL--terminated string representation of an object UUID. Beispielsweise stellt die Zeichenfolge 6B29FC40-CA47-1067-B31D-00DD010662DA eine gültige UUID dar.

ProtSeq

Zeiger auf eine null-terminated string representation of a protocol sequence. Siehe Hinweis.

NetworkAddr

Zeiger auf eine null-terminated string representation of a network address. Das Netzwerkadressenformat ist der Protokollsequenz zugeordnet. Siehe Hinweis.

Endpoint

Zeiger auf eine NULL--terminated-Zeichenfolgendarstellung eines Endpunkts. Das Endpunktformat und der Inhalt sind der Protokollsequenz zugeordnet. Der der Protokollsequenz zugeordnete Endpunkt ncacn_np ist z. B. ein Pipename im Format \pipe\pipename. Siehe Hinweis.

Options

Zeiger auf eine null-terminated string representation of network options. Die Optionszeichenfolge ist der Protokollsequenz zugeordnet. Siehe Hinweis.

StringBinding

Gibt einen Zeiger auf einen Zeiger auf einen NULL--terminated string representation of a binding handle zurück.

Geben Sie einen NULL--Wert an, um zu verhindern, dass RpcStringBindingCompose- den StringBinding-Parameter zurückgibt. In diesem Fall ruft die Anwendung RpcStringFree-nicht auf. Siehe Hinweis.

Rückgabewert

Bemerkungen

Eine Anwendung ruft RpcStringBindingCompose Routine auf, um eine Objekt-UUID, eine Protokollsequenz, eine Netzwerkadresse, einen Endpunkt und andere Netzwerkoptionen in eine Zeichenfolgendarstellung eines Bindungshandle zu kombinieren.

Die RPC-Laufzeitbibliothek weist Speicher für die im StringBinding Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist dafür verantwortlich, RpcStringFree- aufzurufen, um diesen Speicher zu verwalten.

Geben Sie einen null Parameterwert an, oder geben Sie für jede Eingabezeichenfolge, die keine Daten enthält, eine leere Zeichenfolge (\0) an.

Literale umgekehrte Schrägstriche innerhalb von C-Sprachzeichenfolgen müssen an zitiert werden. Die tatsächliche C-Zeichenfolge für den Servernamen für die ncacn_np Protokollsequenz wird als \\Servername angezeigt, und die tatsächliche C-Zeichenfolge für einen Pipenamen wird als \pipe\pipename angezeigt.

Anforderungen

Siehe auch

RpcBindingFromStringBinding

RpcBindingToStringBinding-

RpcStringBindingParse-

RpcStringFree-