RpcNsBindingImportBeginW-Funktion (rpcnsi.h)
Die RpcNsBindingImportBegin-Funktion erstellt einen Importkontext für den Import clientkompatibler Bindungshandles für Server, die die angegebene Schnittstelle und das angegebene Objekt bieten.
Syntax
RPC_STATUS RpcNsBindingImportBeginW(
unsigned long EntryNameSyntax,
RPC_WSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
RPC_NS_HANDLE *ImportContext
);
Parameter
EntryNameSyntax
Syntax des 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
Zeigen Sie auf einen Eintragsnamen, bei dem die Suche nach kompatiblen Bindungshandles beginnt.
Um den im Registrierungswerteintrag angegebenen Eintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryzu 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 kein Problem besteht, geben Sie einen NULL-Wert für diesen Parameter an. In diesem Fall sind die zurückgegebenen Bindungen nur von einer kompatiblen und unterstützten Protokollsequenz und enthalten die angegebene Objekt-UUID. Der kontaktierte Server unterstützt möglicherweise nicht die gewünschte Schnittstelle.
ObjUuid
Zeiger auf ein optionales Objekt UUID.
Für eine nonzero UUID werden kompatible Bindungshandles nur dann von einem Eintrag zurückgegeben, wenn der Server die angegebene Objekt-UUID exportiert hat.
Wenn ObjUuid einen NULL-Zeigerwert oder eine Nil-UUID aufweist, enthalten die zurückgegebenen Bindungshandles einen der vom kompatiblen Server exportierten Objekt-UUIDs. Wenn der Server keine Objekt-UUIDs exportiert hat, enthalten die zurückgegebenen kompatiblen Bindungshandles eine nil-Objekt-UUID.
ImportContext
Name-Service-Handle, das für die 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-Service-Eintrag wurde nicht gefunden. |
|
Der Namensdienst ist nicht verfügbar. |
|
Ungültiges Objekt. |
Bemerkungen
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 Vorgang der funktion RpcNsBindingImportNext.
Wenn der Import von Bindungshandles abgeschlossen ist, ruft die Clientanwendung die RpcNsBindingImportDone--Funktion auf, um den Importkontext zu löschen.
Anmerkung
Der rpcnsi.h-Header definiert RpcNsBindingImportBegin 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 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | rpcnsi.h (include Rpc.h) |
| Library | Rpcns4.lib |
| DLL- | Rpcns4.dll |