Freigeben über

RpcNsProfileEltInqBeginA-Funktion (rpcnsi.h)

  • Artikel

Die RpcNsProfileEltInqBegin-Funktion erstellt einen Untersuchungskontext zum Anzeigen der Elemente in einem Profil.

Hinweis Diese Funktion wird unter Windows Vista und höheren Betriebssystemen nicht unterstützt.
 

Syntax

RPC_STATUS RpcNsProfileEltInqBeginA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  unsigned long InquiryType,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  RPC_NS_HANDLE *InquiryContext
);

Parameter

ProfileNameSyntax

Syntax des ProfileName-.

Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.

ProfileName

Zeigen Sie auf den Namen des anzuzeigenden Profils.

InquiryType

Art der Anfrage, die im Profil ausgeführt werden soll. In der folgenden Tabelle sind gültige Untersuchungstypen aufgeführt.

Anfragetyp Bedeutung
RPC_C_PROFILE_DEFAULT_ELT
 Durchsucht das Profil nach dem Standardprofilelement( falls vorhanden). Die parameter IfId, VersOptionund MemberName parameter werden ignoriert.
RPC_C_PROFILE_ALL_ELTS
 Gibt jedes Element aus dem Profil zurück. Die parameter IfId, VersOptionund MemberName parameter werden ignoriert.
RPC_C_PROFILE_MATCH_BY_IF
 Durchsucht das Profil nach Elementen, die die schnittstellenidentifikation enthalten, die durch IfId und VersOptionangegeben sind. Der parameter MemberName wird ignoriert.
RPC_C_PROFILE_MATCH_BY_MBR
 Durchsucht das Profil nach Elementen, die MemberName-enthalten. Die parameter IfId und VersOption werden ignoriert.
RPC_C_PROFILE_MATCH_BY_BOTH
 Durchsucht das Profil nach Elementen, die die Schnittstellenidentifikation und das Element enthalten, die durch die parameter IfId, VersOptionund MemberName identifiziert wurden.

IfId

Zeiger auf die Schnittstellenidentifikation der Profilelemente, die von der funktion RpcNsProfileEltInqNext zurückgegeben werden sollen.

Der IfId Parameter wird nur verwendet, wenn ein Wert von RPC_C_PROFILE_MATCH_BY_IF oder RPC_C_PROFILE_MATCH_BY_BOTH für den Parameter InquiryType angegeben wird. Andernfalls wird IfId- ignoriert, und ein Nullwert kann angegeben werden.

VersOption

Gibt an, wie die funktion RpcNsProfileEltInqNext den parameter IfId verwendet. Dieser Parameter wird nur verwendet, wenn ein Wert von RPC_C_PROFILE_MATCH_BY_IF oder RPC_C_PROFILE_MATCH_BY_BOTH für InquiryType-angegeben wird. Andernfalls wird dieser Parameter ignoriert, und ein 0-Wert kann angegeben werden.

In der folgenden Tabelle werden gültige Werte für VersOptionbeschrieben.

Wert Bedeutung
RPC_C_VERS_ALL
 Gibt Profilelemente zurück, die die angegebene Schnittstelle UUID bieten, unabhängig von den Versionsnummern. Geben Sie für diesen Wert 0 für die Haupt- und Nebenversionen in IfId-an.
RPC_C_VERS_COMPATIBLE
 Gibt Profilelemente zurück, die dieselbe Hauptversion der angegebenen Schnittstelle UUID und eine Nebenversion größer oder gleich der Nebenversion der angegebenen Schnittstelle UUID bieten.
RPC_C_VERS_EXACT
 Gibt Profilelemente zurück, die die angegebene Version der angegebenen Schnittstelle UUID bieten.
RPC_C_VERS_MAJOR_ONLY
 Gibt Profilelemente zurück, die dieselbe Hauptversion der angegebenen Schnittstelle UUID bieten (ignoriert die Nebenversion). Geben Sie für diesen Wert 0 für die Nebenversion in IfId-an.
RPC_C_VERS_UPTO
 Gibt Profilelemente zurück, die eine Version der angegebenen Schnittstelle UUID kleiner oder gleich der angegebenen Haupt- und Nebenversion bieten. (Wenn z. B. die IfId V2.0 und das Profil enthaltene Elemente mit V1.3, V2.0 und V2.1 enthielt, gibt die RpcNsProfileEltInqNext Funktion Elemente mit V1.3 und V2.0 zurück.)

MemberNameSyntax

Syntax von MemberNameund der Rückgabeparameter MemberName in der Funktion RpcNsProfileEltInqNext.

Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.

MemberName

Zeigen Sie auf den Membernamen, nach dem die funktion RpcNsProfileEltInqNext in Profilelementen sucht. Der parameter MemberName wird nur verwendet, wenn ein Wert von RPC_C_PROFILE_MATCH_BY_MBR oder RPC_C_PROFILE_MATCH_BY_BOTH für InquiryType-angegeben wird. Andernfalls wird MemberName- ignoriert, und ein Nullwert kann angegeben werden.

InquiryContext

Gibt einen Zeiger auf ein Namensdiensthandle für die Verwendung mit den funktionen RpcNsProfileEltInq Next und RpcNsProfileEltInqDone zurück.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_INVALID_VERS_OPTION
 Die Versionsoption ist ungültig.
RPC_S_INVALID_NAME_SYNTAX
 Die Namenssyntax ist ungültig.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 Die Namenssyntax wird nicht unterstützt.
RPC_S_INCOMPLETE_NAME
 Der Name ist unvollständig.
RPC_S_ENTRY_NOT_FOUND
 Der Name-Service-Eintrag wurde nicht gefunden.
RPC_S_NAME_SERVICE_UNAVAILABLE
 Der Namensdienst ist nicht verfügbar.
 
Hinweis Eine Liste gültiger Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Bemerkungen

Die RpcNsProfileEltInqBegin-Funktion erstellt einen Untersuchungskontext zum Anzeigen der Elemente in einem Profil.

Mithilfe des InquiryType-Parameters gibt eine Anwendung an, welche der folgenden Profilelemente von Aufrufen an RpcNsProfileEltInqNext-zurückgegeben werden sollen:

  • Das Standardelement
  • Alle Elemente
  • Elemente mit der angegebenen Schnittstellenidentifikation
  • Elemente mit dem angegebenen Membernamen
  • Elemente mit der angegebenen Schnittstellenidentifikation und dem Membernamen
Vor dem Aufrufen RpcNsProfileEltInqNext-muss die Anwendung zuerst RpcNsProfileEltInqBegin- aufrufen, um einen Anfragekontext zu erstellen.

Nach Abschluss der Anzeige der Profilelemente ruft die Anwendung die RpcNsProfileEltInqDone--Funktion auf, um den Untersuchungskontext zu löschen.

Hinweis Windows 2000 Active Directory diese Funktion unterstützt. Frühere Versionen von Windows NT unterstützen nur die Verwendung dieser Funktion mit dem Cell Directory Service (CDS).
 

Anmerkung

Der rpcnsi.h-Header definiert RpcNsProfileEltInqBegin 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- rpcnsi.h (include Rpc.h)
Library Rpcns4.lib
DLL- Rpcns4.dll

Siehe auch

rpcIfInqId-

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext-