RpcNsProfileEltInqNextW-Funktion (rpcnsi.h)
Die RpcNsProfileEltInqNext-Funktion gibt jeweils ein Element aus einem Profil zurück.
Syntax
RPC_STATUS RpcNsProfileEltInqNextW(
RPC_NS_HANDLE InquiryContext,
RPC_IF_ID *IfId,
RPC_WSTR *MemberName,
unsigned long *Priority,
RPC_WSTR *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 Membernamen 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 Profilelement 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 |
---|---|
|
Der Aufruf war erfolgreich. |
|
Der Name ist unvollständig. |
|
Der Namensdienst ist nicht verfügbar. |
|
Keine weiteren Elemente. |
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 nicht sortiert.
Bei jedem Aufruf von RpcNsProfileEltInqNext , der ein Profilelement zurückgibt, weist die RPC-Laufzeitbibliothek Arbeitsspeicher für den zurückgegebenen Membernamen und die Anmerkungszeichenfolge zu. 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
Der rpcnsi.h-Header definiert RpcNsProfileEltInqNext als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 (include Rpc.h) |
Bibliothek | Rpcns4.lib |
DLL | Rpcns4.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für