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
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Keine Bindungen mehr. |
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 |