RpcNsBindingSelect-Funktion (rpcnsi.h)

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

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

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

Weitere Informationen

RpcBindingFree

RpcNsBindingLookupWeiter

RpcStringBindingParse

select