RpcNsProfileEltInqBeginW-Funktion (rpcnsi.h)

  • Artikel

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

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

Syntax

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

Parameter

ProfileNameSyntax

Syntax von ProfileName.

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

ProfileName

Zeiger auf den Namen des anzuzeigenden Profils.

InquiryType

Art der Anforderung, die für das Profil ausgeführt werden soll. In der folgenden Tabelle sind gültige Abfragetypen aufgeführt.

Abfragetyp Bedeutung
RPC_C_PROFILE_DEFAULT_ELT
 Durchsucht das Profil nach dem Standardprofilelement, falls vorhanden. Die Parameter IfId, VersOption und MemberName werden ignoriert.
RPC_C_PROFILE_ALL_ELTS
 Gibt jedes Element aus dem Profil zurück. Die Parameter IfId, VersOption und MemberName werden ignoriert.
RPC_C_PROFILE_MATCH_BY_IF
 Durchsucht das Profil nach Elementen, die die durch IfId und VersOption angegebene Schnittstellenidentifikation enthalten. Der MemberName-Parameter 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 den Member enthalten, die durch die Parameter IfId, VersOption und MemberName identifiziert werden.

IfId

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

Der IfId-Parameter wird nur verwendet, wenn der Wert 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 NULL-Wert kann angegeben werden.

VersOption

Gibt an, wie die RpcNsProfileEltInqNext-Funktion den IfId-Parameter 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 der Wert 0 kann angegeben werden.

In der folgenden Tabelle werden die gültigen Werte für VersOption beschrieben.

Wert Bedeutung
RPC_C_VERS_ALL
 Gibt Profilelemente zurück, die unabhängig von den Versionsnummern die angegebene Schnittstellen-UUID bieten. Geben Sie für diesen Wert 0 für die Haupt- und Nebenversion in IfId an.
RPC_C_VERS_COMPATIBLE
 Gibt Profilelemente 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 Profilelemente zurück, die die angegebene Version der angegebenen Schnittstellen-UUID bieten.
RPC_C_VERS_MAJOR_ONLY
 Gibt Profilelemente zurück, die die gleiche Hauptversion der angegebenen Schnittstellen-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 Schnittstellen-UUID bieten, die kleiner oder gleich der angegebenen Haupt- und Nebenversion ist. (Wenn beispielsweise die IfId V2.0 enthält und das Profil Elemente mit V1.3, V2.0 und V2.1 enthält, gibt die RpcNsProfileEltInqNext-Funktion Elemente mit V1.3 und V2.0 zurück.)

MemberNameSyntax

Syntax von MemberName und dem Rückgabeparameter MemberName in der RpcNsProfileEltInqNext-Funktion .

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

MemberName

Zeiger auf den Membernamen, nach dem die RpcNsProfileEltInqNext-Funktion in Profilelementen sucht. Der MemberName-Parameter wird nur verwendet, wenn für InquiryType der Wert RPC_C_PROFILE_MATCH_BY_MBR oder RPC_C_PROFILE_MATCH_BY_BOTH angegeben wird. Andernfalls wird MemberName ignoriert, und ein NULL-Wert kann angegeben werden.

InquiryContext

Gibt einen Zeiger auf ein Name-Dienst-Handle zur Verwendung mit den Funktionen RpcNsProfileEltInqNext 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-Dienst-Eintrag wurde nicht gefunden.
RPC_S_NAME_SERVICE_UNAVAILABLE
 Der Namensdienst ist nicht verfügbar.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

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

Mithilfe des Parameters InquiryType gibt eine Anwendung an, welche der folgenden Profilelemente von Aufrufen von 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 von RpcNsProfileEltInqNext muss die Anwendung zuerst RpcNsProfileEltInqBegin aufrufen, um einen Abfragekontext zu erstellen.

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

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

Hinweis

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
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile rpcnsi.h (rpc.h einschließen)
Bibliothek Rpcns4.lib
DLL Rpcns4.dll

Weitere Informationen

RpcIfInqId

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext