RpcNsGroupMbrInqNextA-Funktion (rpcnsi.h)

Die RpcNsGroupMbrInqNext-Funktion 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 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
RPC_S_OK
Der Aufruf war erfolgreich.
RPC_S_INVALID_NS_HANDLE
Das Name-Dienst-Handle ist ungültig.
RPC_S_NO_MORE_MEMBERS
Keine weiteren Member.
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 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 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 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

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree