RpcNsGroupMbrInqNextW-Funktion (rpcnsi.h)

Die funktion RpcNsGroupMbrInqNext gibt jeweils einen Eintragsnamen aus einer Gruppe zurück.

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

 

Syntax

RPC_STATUS RpcNsGroupMbrInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_WSTR      *MemberName
);

Parameter

InquiryContext

Name Service Handle.

MemberName

Gibt die Adresse eines Zeigers auf einen RPC-Gruppenmitgliedsnamen zurück. Die Syntax des zurückgegebenen Namens wurde durch den parameter MemberNameSyntax in der funktion RpcNsGroupMbrInqBegin angegeben.

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

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_NS_HANDLE	Das Namensdiensthandle ist ungültig.
RPC_S_NO_MORE_MEMBERS	Keine weiteren Mitglieder.
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 funktion RpcNsGroupMbrInqNext gibt ein Mitglied der RPC-Gruppe zurück, die durch den Parameter GroupName in RpcNsGroupMbrInqBeginangegeben wird. Eine Anwendung kann alle Mitglieder einer RPC-Gruppe anzeigen, indem wiederholt RpcNsGroupMbrInqNextaufgerufen wird. Wenn alle Gruppenmitglieder angezeigt wurden, gibt diese Funktion einen RPC_S_NO_MORE_MEMBERS Statuscode zurück. Die zurückgegebenen Gruppenmitglieder sind ungeordnet.

Bei jedem Aufruf von RpcNsGroupMbrInqNext-, die einen Membernamen zurückgibt, weist die RPC-Laufzeitbibliothek Speicher für die zurückgegebene MemberName-zu. Die Anwendung ist für das Aufrufen von RpcStringFree- für jede zurückgegebene MemberName- Zeichenfolge verantwortlich. Nach dem Anzeigen der Mitglieder der RPC-Gruppe muss die Anwendung RpcNsGroupMbrInqDone- aufrufen, um den Untersuchungskontext 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 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 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

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

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone-

RpcStringFree-