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 bindungshandle beschreibt, das von diesem Aufruf erstellt werden soll. 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ückgegeben wird.
[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ückgegeben wird.
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ückgegeben wird.
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 RPC_S_OK nicht zurückgibt, sind die Inhalte dieser Struktur nicht definiert. Bei nicht lokalen RPC-Aufrufen muss dieses Handle an RpcBindingBind-übergeben werden.
Rückgabewert
Diese Funktion gibt RPC_S_OK bei Erfolg 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 einzigen unterstützten Protokollsequenzen für diese API sind ncalrpc; Die Auswahl einer anderen Protokollsequenz führt zur Rückgabe dieses Fehlerstatuscodes.
|
Bemerkungen
Das von dieser API zurückgegebene RPC-Bindungshandle kann mit allen anderen Funktionen verwendet werden, die ein Bindungshandle als Parameter akzeptieren.
Bevor jedoch Aufrufe für das Bindungshandle getätigt werden können, muss rpcBindingBind aufgerufen werden, um das Bindungshandle für Remoteanrufe verfügbar zu machen. Die RpcBindingCreate-API berührt das Netzwerk nicht oder versucht, mit dem RPC-Server zu kommunizieren. Stattdessen wird einfach eine interne Datenstruktur basierend auf den in der Vorlage angegebenen Werten erstellt. Eine erfolgreiche Rückgabe gibt nicht an, dass der RPC-Server verfügbar, zugänglich oder richtig angegeben ist.
Anmerkung
Der rpcdce.h-Header definiert RpcBindingCreate als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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 Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | rpcdce.h (include Rpc.h) |
| Library | Rpcrt4.lib |
| DLL- | Rpcrt4.dll |