RpcBindingCreateW-Funktion (rpcdce.h)

  • Artikel

Die RpcBindingCreate-Funktion erstellt ein neues schnelles RPC-Bindungshandle basierend auf einer bereitgestellten Vorlage.

Syntax

RPC_STATUS RpcBindingCreateW(
  [in]           RPC_BINDING_HANDLE_TEMPLATE_V1_W *Template,
  [in, optional] RPC_BINDING_HANDLE_SECURITY_V1_W *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
RPC_S_OK
 Das Bindungshandle wurde erfolgreich erstellt.
RPC_S_CANNOT_SUPPORT
 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.
 
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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

   
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

Weitere Informationen

RPC_BINDING_HANDLE

RpcBindingBind