RpcNsGroupMbrInqNextA-Funktion (rpcnsi.h)
Die RpcNsGroupMbrInqNext-Funktion gibt jeweils einen Eintragsnamen aus einer Gruppe zurück.
Syntax
RPC_STATUS RpcNsGroupMbrInqNextA(
RPC_NS_HANDLE InquiryContext,
RPC_CSTR *MemberName
);
Parameter
InquiryContext
Namensdiensthandle.
MemberName
Gibt die Adresse eines Zeigers auf den Namen eines RPC-Gruppenmitglieds zurück. Die Syntax des zurückgegebenen Namens wurde vom MemberNameSyntax-Parameter in der RpcNsGroupMbrInqBegin-Funktion angegeben.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcNsGroupMbrInqNext den MemberName-Parameter zurückgibt. In diesem Fall ruft die Anwendung die RpcStringFree-Funktion nicht auf.
Rückgabewert
Wert | Bedeutung |
---|---|
|
Der Aufruf war erfolgreich. |
|
Das Name-Dienst-Handle ist ungültig. |
|
Keine weiteren Member. |
|
Der Namensdienst ist nicht verfügbar. |
Hinweise
Die RpcNsGroupMbrInqNext-Funktion gibt ein Mitglied der RPC-Gruppe zurück, die durch den GroupName-Parameter in RpcNsGroupMbrInqBegin angegeben wird. Eine Anwendung kann alle Mitglieder einer RPC-Gruppe anzeigen, die durch wiederholtes Aufrufen von RpcNsGroupMbrInqNext festgelegt wird. Wenn alle Gruppenmitglieder angezeigt wurden, gibt diese Funktion einen RPC_S_NO_MORE_MEMBERS status Code zurück. Die zurückgegebenen Gruppenmitglieder sind ungeordnet.
Bei jedem Aufruf von RpcNsGroupMbrInqNext , der einen Membernamen zurückgibt, ordnet die RPC-Laufzeitbibliothek Arbeitsspeicher für den zurückgegebenen MemberName zu. Die Anwendung ist für den Aufruf von RpcStringFree für jede zurückgegebene MemberName-Zeichenfolge verantwortlich. Nachdem die Mitglieder der RPC-Gruppe angezeigt wurden, muss die Anwendung RpcNsGroupMbrInqDone aufrufen, um den Abfragekontext freizugeben.
Die Reihenfolge, in der Gruppenmitglieder zurückgegeben werden, kann für jede Anzeige einer Gruppe unterschiedlich sein. Dies bedeutet, dass die Reihenfolge, in der Gruppenmitglieder an eine Anwendung zurückgegeben werden, bei jeder Ausführung der Anwendung unterschiedlich sein kann.
Hinweis
Der rpcnsi.h-Header definiert RpcNsGroupMbrInqNext 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
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für