RpcMgmtEpEltInqNext-Funktion (rpcdce.h)

  • Artikel

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
RPC_S_OK
 Der Aufruf war erfolgreich.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

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

Weitere Informationen

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone