RpcBindingCreateA-Funktion (rpcdce.h)
Die RpcBindingCreate-Funktion erstellt ein neues schnelles RPC-Bindungshandle basierend auf einer bereitgestellten Vorlage.
Syntax
RPC_STATUS RpcBindingCreateA(
[in] RPC_BINDING_HANDLE_TEMPLATE_V1_A *Template,
[in, optional] RPC_BINDING_HANDLE_SECURITY_V1_A *Security,
[in, optional] RPC_BINDING_HANDLE_OPTIONS_V1 *Options,
[out] RPC_BINDING_HANDLE *Binding
);
Parameter
[in] Template
RPC_BINDING_HANDLE_TEMPLATE Struktur, die das durch diesen Aufruf zu erstellende Bindungshandle beschreibt. Diese Daten können während des Aufrufs überschrieben werden, sodass die API keinen Verweis auf diese Daten verwaltet. Der Aufrufer muss den von dieser Struktur verwendeten Arbeitsspeicher freigeben, wenn die API zurückgibt.
[in, optional] Security
RPC_BINDING_HANDLE_SECURITY Struktur, die die Sicherheitsoptionen für dieses Bindungshandle beschreibt. Diese Daten können während des Aufrufs überschrieben werden, sodass die API keinen Verweis auf diese Daten verwaltet. Der Aufrufer muss den von dieser Struktur verwendeten Arbeitsspeicher freigeben, wenn die API zurückgibt.
Dieser Parameter ist optional. Wenn dieser Parameter auf NULL festgelegt ist, werden die Standardsicherheitseinstellungen für RPC_BINDING_HANDLE_SECURITY verwendet.
[in, optional] Options
RPC_BINDING_HANDLE_OPTIONS Struktur, die zusätzliche Optionen für das Bindungshandle beschreibt. Diese Daten können während des Aufrufs überschrieben werden, sodass die API keinen Verweis auf diese Daten verwaltet. Der Aufrufer muss den von dieser Struktur verwendeten Arbeitsspeicher freigeben, wenn die API zurückgibt.
Dieser Parameter ist optional. Wenn dieser Parameter auf NULL festgelegt ist, werden die Standardoptionen für RPC_BINDING_HANDLE_OPTIONS verwendet.
[out] Binding
RPC_BINDING_HANDLE Struktur, die das neu erstellte Bindungshandle enthält. Wenn diese Funktion nicht RPC_S_OK zurückgegeben hat, ist der Inhalt dieser Struktur nicht definiert. Bei nicht lokalen RPC-Aufrufen muss dieses Handle an RpcBindingBind übergeben werden.
Rückgabewert
Diese Funktion gibt bei Erfolg RPC_S_OK zurück. Andernfalls wird ein RPC_S_*-Fehlercode zurückgegeben. Informationen zu diesen Fehlercodes finden Sie unter RPC-Rückgabewerte.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Bindungshandle wurde erfolgreich erstellt. |
|
Für dieses Bindungshandle wurde ein veraltetes Feature von RPC angefordert.
Hinweis Die einzige unterstützte Protokollsequenz für diese API ist ncalrpc. Wenn Sie eine andere Protokollsequenz auswählen, wird dieser Fehler status Code zurückgegeben.
|
Hinweise
Das von dieser API zurückgegebene RPC-Bindungshandle kann mit allen anderen Funktionen verwendet werden, die ein Bindungshandle als Parameter akzeptiert.
Bevor jedoch Aufrufe für das Bindungshandle ausgeführt werden können, muss RpcBindingBind aufgerufen werden, um das Bindungshandle für Remoteaufrufe verfügbar zu machen. Die RpcBindingCreate-API berührt nicht das Netzwerk oder versucht, mit dem RPC-Server zu kommunizieren. Vielmehr erstellt sie einfach eine interne Datenstruktur basierend auf den in der Vorlage angegebenen Werten. Eine erfolgreiche Rückgabe bedeutet nicht, dass der RPC-Server verfügbar, zugänglich oder ordnungsgemäß angegeben ist.
Hinweis
Der rpcdce.h-Header definiert RpcBindingCreate 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 nicht codierungsneutralem Code 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcdce.h (include Rpc.h) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |