RpcMgmtEpEltInqNext-Funktion (rpcdce.h)
Die RpcMgmtEpEltInqNext-Funktion gibt ein Element aus einer Endpunktzuordnung zurück.
Syntax
RPC_STATUS RpcMgmtEpEltInqNext(
RPC_EP_INQ_HANDLE InquiryContext,
RPC_IF_ID *IfId,
RPC_BINDING_HANDLE *Binding,
RPC_CSTR *Annotation
);
Parameter
InquiryContext
Gibt einen Abfragekontext an. Der Abfragekontext wird von RpcMgmtEpEltInqBegin zurückgegeben.
IfId
Gibt den Schnittstellenbezeichner des endpoint-map-Elements zurück.
Binding
Optional. Gibt das Bindungshandle aus dem endpoint-map-Element zurück.
Annotation
Optional. Gibt die Anmerkungszeichenfolge für das endpoint-map-Element zurück. Wenn im endpoint-map-Element keine Anmerkungszeichenfolge vorhanden ist, wird die leere Zeichenfolge ("") zurückgegeben.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
Hinweise
Die RpcMgmtEpEltInqNext-Funktion gibt ein Element aus der Endpunktzuordnung zurück. Ausgewählte Elemente hängen vom Abfragekontext ab. Die Auswahlkriterien werden von InquiryType der RpcMgmtEpEltInqBegin-Funktion bestimmt, die InquiryContext zurückgegeben hat.
Eine Anwendung kann alle ausgewählten Endpunktzuordnungselemente anzeigen, indem sie rpcMgmtEpEltInqNext wiederholt aufruft. Wenn alle Elemente angezeigt wurden, gibt diese Funktion eine RPC_X_NO_MORE_ENTRIES status zurück. Die zurückgegebenen Elemente sind nicht sortiert.
Wenn die entsprechenden Argumente nicht NULL sind, weist die RPC-Laufzeitfunktionsbibliothek arbeitsspeicher für Bindung und Anmerkung für jeden Aufruf dieser Funktion zu. Die Anwendung ist für den Aufruf von RpcBindingFree für jede zurückgegebene Bindung und RpcStringFree für jede zurückgegebene Anmerkung verantwortlich.
Nach dem Anzeigen der Endpunktzuordnungselemente muss die Anwendung RpcMgmtEpEltInqDone aufrufen, um den Abfragekontext zu löschen.
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 | rpcdce.h (include Rpc.h) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |