RpcNsBindingLookupBeginA-Funktion (rpcnsi.h)
Die RpcNsBindingLookupBegin--Funktion erstellt einen Nachschlagekontext für eine Schnittstelle und ein Objekt.
Syntax
RPC_STATUS RpcNsBindingLookupBeginA(
unsigned long EntryNameSyntax,
RPC_CSTR EntryName,
RPC_IF_HANDLE IfSpec,
UUID *ObjUuid,
unsigned long BindingMaxCount,
RPC_NS_HANDLE *LookupContext
);
Parameter
EntryNameSyntax
Syntax des parameters EntryName.
Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.
EntryName
Zeigen Sie auf einen Eintragsnamen, bei dem die Suche nach kompatiblen Bindungen 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 Struktur, die die Schnittstelle angibt, die nachschlagen soll. 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. Die gewünschte Schnittstelle wird möglicherweise vom kontaktierten Server nicht unterstützt.
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.
Bei einem Nullzeigerwert oder einer Nil-UUID für diesen Parameter enthalten die zurückgegebenen Bindungshandles eines der Objekt-UUIDs, die vom kompatiblen Server exportiert werden. Wenn der Server keine Objekt-UUIDs exportiert hat, enthalten die zurückgegebenen kompatiblen Bindungshandles eine nil-Objekt-UUID.
BindingMaxCount
Maximale Anzahl von Bindungen, die im parameter BindingVec aus der funktion RpcNsBindingLookupNext zurückgegeben werden sollen.
Geben Sie einen Wert von Null an, um die Standardanzahl von RPC_C_BINDING_MAX_COUNT_DEFAULT zu verwenden.
LookupContext
Gibt einen Zeiger auf ein Namensdiensthandle für die Verwendung mit den funktionen RpcNsBindingLookupNext und RpcNsBindingLookupDone- zurück.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Namenssyntax ist ungültig. |
|
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
Die RpcNsBindingLookupBegin-Funktion erstellt einen Nachschlagekontext zum Suchen clientkompatibler Bindungshandles an Server, die die angegebene Schnittstelle und das angegebene Objekt bieten.
Vor dem Aufrufen RpcNsBindingLookupNext-muss die Clientanwendung zuerst RpcNsBindingLookupBegin- aufrufen, um einen Nachschlagekontext zu erstellen. Die Parameter für diese Funktion steuern den Vorgang der funktion RpcNsBindingLookupNext.
Ab Windows 2000 verwendet die RPC-Umgebung Active Directory als Name-Service-Datenbank und die Reihenfolge, in der die Laufzeitumgebung die Suche durchführt, wie folgt:
- Suchen Sie im lokalen Cache.
- Wenn der Eintrag im lokalen Cache nicht gefunden wurde, suchen Sie das Active Directory dieses Computers.
- Wenn der Eintrag auf dem lokalen Computer nicht gefunden wurde, senden Sie Übertragungsanforderungen an alle anderen Active Directory-Dienste in der Domäne.
Beachten Sie, dass die Laufzeitumgebung diese Übertragungsanforderung nicht ausgibt, wenn der Eintrag im Active Directory vorhanden ist, aber keine Informationen mit dem Eintrag verknüpft sind.
Anmerkung
Der rpcnsi.h-Header definiert RpcNsBindingLookupBegin 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 |