RpcNsBindingImportBeginA-Funktion (rpcnsi.h)

Die RpcNsBindingImportBegin-Funktion erstellt einen Importkontext zum Importieren clientkompatibler Bindungshandles für Server, die die angegebene Schnittstelle und das angegebene Objekt bieten.

Syntax

RPC_STATUS RpcNsBindingImportBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  RPC_NS_HANDLE *ImportContext
);

Parameter

EntryNameSyntax

Syntax von EntryName.

Geben Sie RPC_C_NS_SYNTAX_DEFAULT an, um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden.

EntryName

Zeiger auf einen Eintragsnamen, unter dem die Suche nach kompatiblen Bindungshandles beginnt.

Um den im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryangegebenen Eintragsnamen zu verwenden, geben Sie einen NULL-Zeiger oder eine leere Zeichenfolge an. In diesem Fall wird der EntryNameSyntax-Parameter ignoriert, und die Laufzeitbibliothek verwendet die Standardsyntax.

IfSpec

Stub-generierte Datenstruktur, die die zu importierende Schnittstelle angibt. Wenn die Schnittstellenspezifikation nicht exportiert wurde oder für den Aufrufer keine Rolle spielt, geben Sie einen NULL-Wert für diesen Parameter an. In diesem Fall ist nur garantiert, dass die zurückgegebenen Bindungen eine kompatible und unterstützte Protokollsequenz haben und die angegebene Objekt-UUID enthalten. Der kontaktierte Server unterstützt möglicherweise nicht die gewünschte Schnittstelle.

ObjUuid

Zeiger auf eine optionale Objekt-UUID.

Bei einer nichtzero-UUID werden kompatible Bindungshandles nur dann von einem Eintrag zurückgegeben, wenn der Server die angegebene Objekt-UUID exportiert hat.

Wenn ObjUuid über einen NULL-Zeigerwert oder eine Null-UUID verfügt, enthalten die zurückgegebenen Bindungshandles eine der Objekt-UUIDs, die vom kompatiblen Server exportiert werden. Wenn der Server keine Objekt-UUIDs exportiert hat, enthalten die zurückgegebenen kompatiblen Bindungshandles eine Null-Objekt-UUID.

ImportContext

Name-Service-Handle, das zur Verwendung mit den Funktionen RpcNsBindingImportNext und RpcNsBindingImportDone zurückgegeben wird.

Rückgabewert

Hinweise

Vor dem Aufrufen der RpcNsBindingImportNext-Funktion muss die Clientanwendung zuerst RpcNsBindingImportBegin aufrufen, um einen Importkontext zu erstellen. Die Parameter für diese Funktion steuern den Betrieb der RpcNsBindingImportNext-Funktion .

Nach Abschluss des Importierens von Bindungshandles ruft die Clientanwendung die RpcNsBindingImportDone-Funktion auf, um den Importkontext zu löschen.

Anforderungen

Weitere Informationen

RpcNsBindingImportDone

RpcNsBindingImportNext