RpcNsEntryObjectInqNext-Funktion (rpcnsi.h)
Die RpcNsEntryObjectInqNext-Funktion gibt jeweils ein Objekt aus einem Name-Service-Datenbankeintrag zurück.
Syntax
RPC_STATUS RpcNsEntryObjectInqNext(
RPC_NS_HANDLE InquiryContext,
UUID *ObjUuid
);
Parameter
InquiryContext
Name-Service-Handle, das die Objekt-UUIDs für einen Name-Dienst-Datenbankeintrag angibt.
ObjUuid
Gibt einen Zeiger auf eine exportierte Objekt-UUID zurück.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Keine weiteren Member. |
|
Der Name ist unvollständig. |
|
Der Name-Dienst-Eintrag wurde nicht gefunden. |
|
Der Namensdienst ist nicht verfügbar. |
Hinweise
Die RpcNsEntryObjectInqNext-Funktion gibt eines der Objekt-UUIDs zurück, die in den Datenbankeintrag name-service exportiert werden, der durch den EntryName-Parameter in der RpcNsEntryObjectInqBegin-Funktion angegeben wird.
Eine Anwendung kann alle exportierten Objekt-UUIDs anzeigen, indem rpcNsEntryObjectInqNext wiederholt aufgerufen wird. Wenn alle Objekt-UUIDs angezeigt wurden, gibt diese Funktion einen RPC_S_NO_MORE_MEMBERS status Code zurück. Die zurückgegebenen Objekt-UUIDs sind nicht sortiert.
Die Anwendung stellt den Arbeitsspeicher für die Objekt-UUID bereit, die im ObjUuid-Parameter zurückgegeben wird.
Nach dem Anzeigen der Objekt-UUIDs muss die Anwendung die RpcNsEntryObjectInqDone-Funktion aufrufen, um den Abfragekontext freizugeben.
Die Reihenfolge, in der Objekt-UUIDs zurückgegeben werden, kann für jede Anzeige eines Eintrags unterschiedlich sein. Dies bedeutet, dass die Reihenfolge, in der Objekt-UUIDs an eine Anwendung zurückgegeben werden, bei jeder Ausführung der Anwendung unterschiedlich sein kann.
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 |