RpcNsBindingLookupBeginW-Funktion (rpcnsi.h)

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

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

 

Syntax

RPC_STATUS RpcNsBindingLookupBeginW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      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, an dem die Suche nach kompatiblen Bindungen beginnt.

Um den eintragsnamen zu verwenden, der im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntryangegeben ist, 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 aufweisen und die angegebene Objekt-UUID enthalten. Die gewünschte Schnittstelle wird vom kontaktierten Server möglicherweise nicht unterstützt.

ObjUuid

Zeiger auf eine optionale Objekt-UUID.

Für eine UUID ungleich Null 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 der RpcNsBindingLookupNext-Funktion zurückgegeben werden sollen.

Geben Sie den Wert 0 (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 für Server, 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 Vorgang 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 im lokalen Cache nicht gefunden wurde, suchen Sie in Active Directory dieses Computers.
• Wenn der Eintrag auf dem lokalen Computer nicht gefunden wird, senden Sie Broadcastanforderungen an alle anderen Active Directory-Dienste in der Domäne.

  Beachten Sie, dass, wenn der Eintrag im Active Directory vorhanden ist, dem Eintrag jedoch keine Informationen zugeordnet sind, die Laufzeitumgebung diese Übertragungsanforderung nicht ausgibt.

Wenn die Suche nach Bindungshandles abgeschlossen ist, ruft die Clientanwendung die RpcNsBindingLookupDone-Funktion auf, um den Nachschlagekontext zu löschen.

Hinweis

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
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 (rpc.h einschließen)
Bibliothek	Rpcns4.lib
DLL	Rpcns4.dll

Weitere Informationen

RpcNsBindingLookupDone

RpcNsBindingLookupWeiter