Freigeben über


RpcNsBindingLookupBeginA-Funktion (rpcnsi.h)

Die RpcNsBindingLookupBegin-Funktion erstellt einen Nachschlagekontext für eine Schnittstelle und ein Objekt.

Hinweis Diese Funktion wird unter Windows Vista und höheren Betriebssystemen nicht unterstützt.
 

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
RPC_S_OK
Der Aufruf war erfolgreich.
RPC_S_INVALID_NAME_SYNTAX
Die Namenssyntax ist ungültig.
RPC_S_UNSUPPORTED_NAME_SYNTAX
Die Namenssyntax wird nicht unterstützt.
RPC_S_INCOMPLETE_NAME
Der Name ist unvollständig.
RPC_S_ENTRY_NOT_FOUND
Der Name-Dienst-Eintrag wurde nicht gefunden.
RPC_S_NAME_SERVICE_UNAVAILABLE
Der Namensdienst ist nicht verfügbar.
RPC_S_INVALID_OBJECT
Ungültiges Objekt.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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.

Nach Abschluss der Suche nach Bindungshandles ruft die Clientanwendung die RpcNsBindingLookupDone-Funktion auf, um den Nachschlagekontext zu löschen.

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

Weitere Informationen

RpcNsBindingLookupDone

RpcNsBindingLookupWeiter