RpcNsEntryObjectInqNext-Funktion (rpcnsi.h)

  • Artikel

Die RpcNsEntryObjectInqNext-Funktion gibt jeweils ein Objekt aus einem Name-Service-Datenbankeintrag zurück.

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

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
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_NO_MORE_MEMBERS
 Keine weiteren Member.
RPC_S_INCOMPLETE_NAME
 Der Name ist unvollständig.
RPC_S_ENTRY_NOT_FOUND
 Der Name-Dienst-Eintrag wurde nicht gefunden.
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 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

Weitere Informationen

RpcNsBindingExport

RpcNsEntryObjectInqBegin

RpcNsEntryObjectInqDone