RpcMgmtEpEltInqNextA-Funktion (rpcdce.h)

  • Artikel

Die RpcMgmtEpEltInqNext-Funktion gibt ein Element aus einer Endpunktzuordnung zurück.

Syntax

RPC_STATUS RpcMgmtEpEltInqNextA(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  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.

ObjectUuid

Optional. Gibt die Objekt-UUID aus dem endpoint-map-Element zurück.

Annotation

Optional. Gibt die Anmerkungszeichenfolge für das endpoint-map-Element zurück. Wenn keine Anmerkungszeichenfolge im endpoint-map-Element 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 durch InquiryType der RpcMgmtEpEltInqBegin-Funktion bestimmt, die InquiryContext zurückgegeben hat.

Eine Anwendung kann alle ausgewählten Endpunktzuordnungselemente anzeigen, indem rpcMgmtEpEltInqNext wiederholt aufgerufen wird. Wenn alle Elemente angezeigt wurden, gibt diese Funktion einen RPC_X_NO_MORE_ENTRIES status zurück. Die zurückgegebenen Elemente sind ungeordnet.

Wenn die entsprechenden Argumente ungleich NULL sind, ordnet die RPC-Laufzeitfunktionsbibliothek bei jedem Aufruf dieser Funktion Arbeitsspeicher für Bindung und Anmerkung 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.

Hinweis

Der rpcdce.h-Header definiert RpcMgmtEpEltInqNext als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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 (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone