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
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Zeichenfolgendarstellung der UUID ist ungültig. |
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.
Anmerkung
Der header rpcdce.h definiert RpcStringBindingCompose 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 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 |