RpcNsProfileEltInqNextA-Funktion (rpcnsi.h)

Artikel
08/25/2023

Die RpcNsProfileEltInqNext-Funktion gibt jeweils ein Element aus einem Profil zurück.

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

Syntax

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

Parameter

InquiryContext

Name-Service-Handle, das von der RpcNsProfileEltInqBegin-Funktion zurückgegeben wird.

IfId

Gibt einen Zeiger auf die Schnittstellenidentifikation des Profilelements zurück.

MemberName

Gibt einen Zeiger auf einen Zeiger auf den Elementnamen des Profilelements zurück. Die Syntax des zurückgegebenen Namens wurde vom MemberNameSyntax-Parameter in der RpcNsProfileEltInqBegin-Funktion angegeben.

Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcNsProfileEltInqNext den MemberName-Parameter zurückgibt. In diesem Fall ruft die Anwendung die RpcStringFree-Funktion nicht auf.

Priority

Gibt einen Zeiger auf die Profilelementpriorität zurück.

Annotation

Gibt einen Zeiger auf einen Zeiger auf die Anmerkungszeichenfolge für das profile-Element zurück. Wenn im Profilelement keine Anmerkungszeichenfolge vorhanden ist, wird die Zeichenfolge \0 zurückgegeben.

Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcNsProfileEltInqNext den Annotation-Parameter zurückgibt. In diesem Fall muss die Anwendung die RpcStringFree-Funktion nicht aufrufen.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INCOMPLETE_NAME	Der Name ist unvollständig.
RPC_S_NAME_SERVICE_UNAVAILABLE	Der Namensdienst ist nicht verfügbar.
RPC_S_NO_MORE_ELEMENTS	Keine weiteren Elemente.

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

Hinweise

Die RpcNsProfileEltInqNext-Funktion gibt ein Element aus dem Profil zurück, das durch den ProfileName-Parameter in RpcNsProfileEltInqBegin angegeben wird. Unabhängig vom Wert von InquiryType in RpcNsProfileEltInqBegin gibt RpcNsProfileEltInqNext alle Komponenten (Schnittstellenidentifikation, Membername, Priorität, Anmerkungszeichenfolge) eines Profilelements zurück.

Eine Anwendung kann alle ausgewählten Profileinträge anzeigen, indem die RpcNsProfileEltInqNext-Funktion wiederholt aufgerufen wird. Wenn alle Elemente angezeigt wurden, gibt diese Funktion einen RPC_S_NO_MORE_ELEMENTS status Code zurück. Die zurückgegebenen Elemente sind ungeordnet.

Bei jedem Aufruf von RpcNsProfileEltInqNext , der ein Profilelement zurückgibt, belegt die RPC-Laufzeitbibliothek Arbeitsspeicher für den zurückgegebenen Membernamen und die Anmerkungszeichenfolge. Die Anwendung ist für den Aufruf der RpcStringFree-Funktion für jeden zurückgegebenen Membernamen und jede Anmerkungszeichenfolge verantwortlich. Nach dem Anzeigen der Profilelemente muss die Anwendung RpcNsProfileEltInqDone aufrufen, um den Abfragekontext freizugeben.

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 RpcNsProfileEltInqNext 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

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

Share via