RpcMgmtEpEltInqNextW-Funktion (rpcdce.h)

Artikel
11/20/2024

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

Syntax

RPC_STATUS RpcMgmtEpEltInqNextW(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_WSTR           *Annotation
);

Parameter

InquiryContext

Gibt einen Untersuchungskontext an. Der Untersuchungskontext wird von RpcMgmtEpEltInqBeginzurückgegeben.

IfId

Gibt den Schnittstellenbezeichner des Endpunktzuordnungselements zurück.

Binding

Wahlfrei. Gibt das Bindungshandle aus dem Endpunktzuordnungselement zurück.

ObjectUuid

Wahlfrei. Gibt das Objekt UUID aus dem Endpunktzuordnungselement zurück.

Annotation

Wahlfrei. Gibt die Anmerkungszeichenfolge für das Endpunktzuordnungselement zurück. Wenn im Endpunktzuordnungselement keine Anmerkungszeichenfolge vorhanden ist, wird die leere Zeichenfolge ("") zurückgegeben.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.

Hinweis Eine Liste gültiger Fehlercodes finden Sie unter RPC-Rückgabewerte.

Bemerkungen

Die RpcMgmtEpEltInqNext--Funktion gibt ein Element aus der Endpunktzuordnung zurück. Die ausgewählten Elemente hängen vom Untersuchungskontext ab. Die Auswahlkriterien werden durch InquiryType- der RpcMgmtEpEltInqBegin Funktion bestimmt, die InquiryContext-zurückgegeben hat.

Eine Anwendung kann alle ausgewählten Endpunktzuordnungselemente anzeigen, indem wiederholt RpcMgmtEpEltInqNext-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, weist die RPC-Laufzeitfunktionsbibliothek Speicher für Binding und Annotation für jeden Aufruf dieser Funktion zu. Die Anwendung ist für das Aufrufen RpcBindingFree- für jede zurückgegebene Binding und RpcStringFree- für jede zurückgegebene Annotationverantwortlich.

Nach dem Anzeigen der Endpunktzuordnungselemente muss die Anwendung RpcMgmtEpEltInqDone- aufrufen, um den Untersuchungskontext zu löschen.

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll

Siehe auch

rpcEpRegister-

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone

Freigeben über