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
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Namenssyntax ist ungültig. |
|
Der Name überschreitet die maximale Länge. |
|
Die Namenssyntax wird nicht unterstützt. |
|
Der Name ist unvollständig. |
|
Der Name-Dienst-Eintrag wurde nicht gefunden. |
|
Der Namensdienst ist nicht verfügbar. |
|
Ungültiges Objekt. |
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.
Hinweis
Der rpcnsi.h-Header definiert RpcNsBindingImportBegin 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 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcnsi.h (include Rpc.h) |
| Bibliothek | Rpcns4.lib |
| DLL | Rpcns4.dll |