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 EntryName-Parameters .
Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie den Wert RPC_C_NS_SYNTAX_DEFAULT an.
EntryName
Zeiger auf einen Eintragsnamen, unter dem die Suche nach kompatiblen Bindungen 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 Struktur, die die nachschlagende 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. Die gewünschte Schnittstelle wird möglicherweise vom kontaktierten Server nicht unterstützt.
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.
Für einen NULL-Zeigerwert oder eine Null-UUID für diesen Parameter 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.
BindingMaxCount
Maximale Anzahl von Bindungen, die im BindingVec-Parameter von der RpcNsBindingLookupNext-Funktion zurückgegeben werden sollen.
Geben Sie den Wert null an, um die Standardanzahl von RPC_C_BINDING_MAX_COUNT_DEFAULT zu verwenden.
LookupContext
Gibt einen Zeiger auf ein Name-Dienst-Handle zur 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-Dienst-Eintrag wurde nicht gefunden. |
|
Der Namensdienst ist nicht verfügbar. |
|
Ungültiges Objekt. |
Hinweise
Die RpcNsBindingLookupBegin-Funktion erstellt einen Suchkontext zum Suchen clientkompatibler Bindungshandles zu Servern, die die angegebene Schnittstelle und das angegebene Objekt anbieten.
Vor dem Aufrufen von RpcNsBindingLookupNext muss die Clientanwendung zuerst RpcNsBindingLookupBegin aufrufen, um einen Nachschlagekontext zu erstellen. Die Parameter für diese Funktion steuern den Betrieb der RpcNsBindingLookupNext-Funktion .
Ab Windows 2000 verwendet die RPC-Umgebung active Directory als Name-Dienst-Datenbank, und die Reihenfolge, in der die Laufzeitumgebung die Suche ausführt, lautet wie folgt:
- Suchen Sie im lokalen Cache.
- Wenn der Eintrag nicht im lokalen Cache gefunden wurde, suchen Sie im Active Directory dieses Computers.
- Wenn der Eintrag auf dem lokalen Computer nicht gefunden wurde, senden Sie Broadcastanforderungen an alle anderen Active Directory-Dienste in der Domäne.
Beachten Sie, dass die Laufzeitumgebung diese Broadcastanforderung nicht ausgibt, wenn der Eintrag im Active Directory vorhanden ist, aber keine Informationen dem Eintrag zugeordnet sind.
Hinweis
Der rpcnsi.h-Header definiert RpcNsBindingLookupBegin 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
| Anforderung | Wert |
|---|---|
| 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 |