RpcNsBindingSelect-Funktion (rpcnsi.h)

  • Artikel

Die RpcNsBindingSelect-Funktion gibt ein Bindungshandle aus einer Liste kompatibler Bindungshandles zurück.

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

Syntax

RPC_STATUS RpcNsBindingSelect(
  RPC_BINDING_VECTOR *BindingVec,
  RPC_BINDING_HANDLE *Binding
);

Parameter

BindingVec

Zeiger auf den Vektor clientkompatibler Serverbindungshandles, aus dem ein Bindungshandle ausgewählt wird. Der zurückgegebene Bindungsvektor verweist nicht mehr auf das ausgewählte Bindungshandle, das separat im Binding-Parameter zurückgegeben wird.

Binding

Zeiger auf ein ausgewähltes Bindungshandle.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_NO_MORE_BINDINGS
 Keine Bindungen mehr.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Jedes Mal, wenn der Client die RpcNsBindingSelect-Funktion aufruft , gibt der Funktionsvorgang ein weiteres Bindungshandle aus dem Vektor zurück.

Wenn alle Bindungshandles vom Vektor zurückgegeben wurden, gibt die Funktion eine status von RPC_S_NO_MORE_BINDINGS und den BindungswertNULL zurück.

Der Select-Vorgang weist Speicher für die Daten zu, auf die vom zurückgegebenen Bindungsparameter verwiesen wird. Wenn ein Client das Bindungshandle abgeschlossen hat, sollte er die RpcBindingFree-Funktion aufrufen, um die Zuordnung des Speichers zu beheben. Jeder Aufruf von RpcNsBindingSelect erfordert einen entsprechenden Aufruf der RpcBindingFree-Funktion .

Clients können eigene Auswahlroutinen erstellen, die anwendungsspezifische Auswahlkriterien implementieren. In diesem Fall ermöglicht RpcStringBindingParse den Zugriff auf die Felder einer Bindung.

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

RpcBindingFree

RpcNsBindingLookupWeiter

RpcStringBindingParse

select