RpcMgmtEpEltInqBegin-Funktion (rpcdce.h)

Artikel
03/01/2024

Die RpcMgmtEpEltInqBegin-Funktion erstellt einen Abfragekontext zum Anzeigen der Elemente in einer Endpunktzuordnung.

Syntax

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

Parameter

EpBinding

Bindungshandle an einen Host, dessen Endpunktzuordnungselemente angezeigt werden sollen. Geben Sie NULL an, um Elemente vom lokalen Host anzuzeigen. Wenn ein Bindungshandle angegeben wird, muss die Objekt-UUID für das Bindungshandle NULL sein. Falls vorhanden, wird der Endpunkt im Bindungshandle ignoriert, und der Endpunkt zur Endpunktzuordnungsdatenbank auf dem angegebenen Host wird verwendet.

InquiryType

Ganzzahliger Wert, der den Typ der Abfrage angibt, die für die Endpunktzuordnung ausgeführt werden soll. Im Folgenden sind gültige Abfragetypen aufgeführt.

Wert	Bedeutung
RPC_C_EP_ALL_ELTS	Gibt jedes Element aus der Endpunktzuordnung zurück. Die Parameter IfId, VersOption und ObjectUuid werden ignoriert.
RPC_C_EP_MATCH_BY_IF	Durchsucht die Endpunktzuordnung nach Elementen, die den schnittstellenbezeichner enthalten, der durch die Werte IfId und VersOption angegeben wird.
RPC_C_EP_MATCH_BY_OBJ	Durchsucht die Endpunktzuordnung nach Elementen, die die durch ObjectUuid angegebene Objekt-UUID enthalten.
RPC_C_EP_MATCH_BY_BOTH	Durchsucht die Endpunktzuordnung nach Elementen, die den Schnittstellenbezeichner und die Objekt-UUID enthalten, die durch IfId, VersOption und ObjectUuid angegeben sind.

IfId

Schnittstellenbezeichner der endpoint-map-Elemente, die von RpcMgmtEpEltInqNext zurückgegeben werden sollen. Dieser Parameter wird nur verwendet, wenn InquiryType entweder RPC_C_EP_MATCH_BY_IF oder RPC_C_EP_MATCH_BY_BOTH ist. Andernfalls wird sie ignoriert.

VersOption

Gibt an, wie RpcMgmtEpEltInqNext den IfId-Parameter verwendet. Dieser Parameter wird nur verwendet, wenn InquiryType entweder RPC_C_EP_MATCH_BY_IF oder RPC_C_EP_MATCH_BY_BOTH ist. Andernfalls wird sie ignoriert. Im Folgenden sind gültige Werte für diesen Parameter aufgeführt.

Wert	Bedeutung
RPC_C_VERS_ALL	Gibt Endpunktzuordnungselemente zurück, die unabhängig von den Versionsnummern die angegebene Schnittstellen-UUID bieten.
RPC_C_VERS_COMPATIBLE	Gibt Endpunktzuordnungselemente zurück, die dieselbe Hauptversion der angegebenen Schnittstellen-UUID und eine Nebenversion bieten, die größer oder gleich der Nebenversion der angegebenen Schnittstellen-UUID ist.
RPC_C_VERS_EXACT	Gibt Endpunktzuordnungselemente zurück, die die angegebene Version der angegebenen Schnittstellen-UUID bieten.
RPC_C_VERS_MAJOR_ONLY	Gibt Endpunktzuordnungselemente zurück, die die gleiche Hauptversion der angegebenen Schnittstellen-UUID bieten, und ignoriert die Nebenversion.
RPC_C_VERS_UPTO	Gibt Endpunktzuordnungselemente zurück, die eine Version der angegebenen Schnittstellen-UUID bieten, die kleiner oder gleich der angegebenen Haupt- und Nebenversion ist.

ObjectUuid

Die Objekt-UUID, nach der RpcMgmtEpEltInqNext in endpoint-map-Elementen sucht. Dieser Parameter wird nur verwendet, wenn InquiryType entweder RPC_C_EP_MATCH_BY_OBJ oder RPC_C_EP_MATCH_BY_BOTH ist.

InquiryContext

Gibt einen Abfragekontext für die Verwendung mit RpcMgmtEpEltInqNext und RpcMgmtEpEltInqDone zurück. Siehe RPC_EP_INQ_HANDLE.

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 RpcMgmtEpEltInqBegin-Funktion erstellt einen Abfragekontext zum Anzeigen von Serveradresseninformationen, die in der Endpunktzuordnung gespeichert sind. Mithilfe von InquiryType und VersOption gibt eine Anwendung an, welche der folgenden Endpunktzuordnungselemente von Aufrufen von RpcMgmtEpEltInqNext zurückgegeben werden sollen:

Alle Elemente
Diese Elemente mit dem angegebenen Schnittstellenbezeichner
Diese Elemente mit der angegebenen Objekt-UUID
Diese Elemente mit dem angegebenen Schnittstellenbezeichner und der objektspezifischen UUID

Vor dem Aufrufen von RpcMgmtEpEltInqNext muss die Anwendung zuerst diese Funktion aufrufen, um einen Abfragekontext zu erstellen. Nach dem Anzeigen der endpoint-map-Elemente ruft die Anwendung RpcMgmtEpEltInqDone auf, 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 (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext

Freigeben über