Freigeben über

RpcNsEntryObjectInqBeginW-Funktion (rpcnsi.h)

Die RpcNsEntryObjectInqBegin-Funktion erstellt einen Untersuchungskontext für die Objekte eines Namensdienstdatenbankeintrags.

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

Syntax

RPC_STATUS RpcNsEntryObjectInqBeginW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_NS_HANDLE *InquiryContext
);

Parameter

EntryNameSyntax

Syntax, die in EntryName-verwendet werden soll.

Um die im Registrierungswerteintrag HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxangegebene Syntax zu verwenden, geben Sie einen Wert von RPC_C_NS_SYNTAX_DEFAULT an.

EntryName

Zeiger auf den Namen-Dienst-Datenbankeintragsnamen, für den Objekt-UUIDs angezeigt werden sollen.

InquiryContext

Gibt einen Zeiger auf ein Namensdiensthandle für die Verwendung mit den funktionen RpcNsEntryObjectInqNext und RpcNsEntryObjectInqDone zurück.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_INVALID_NAME_SYNTAX
 Die Namenssyntax ist ungültig.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 Die Namenssyntax wird nicht unterstützt.
RPC_S_INCOMPLETE_NAME
 Der Name ist unvollständig.
RPC_S_ENTRY_NOT_FOUND
 Der Name-Service-Eintrag wurde nicht gefunden.
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 RpcNsEntryObjectInqBegin-Funktion erstellt einen Untersuchungskontext zum Anzeigen der Objekt-UUIDs, die in EntryNameexportiert wurden.

Vor dem Aufrufen der RpcNsEntryObjectInqNext--Funktion muss die Anwendung zuerst RpcNsEntryObjectInqBegin aufrufen, um einen Untersuchungskontext zu erstellen.

Nach Abschluss der Anzeige der Objekt-UUIDs ruft die Anwendung die RpcNsEntryObjectInqDone--Funktion auf, um den Untersuchungskontext zu löschen.

Anmerkung

Der rpcnsi.h-Header definiert RpcNsEntryObjectInqBegin 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

RpcNsBindingExport-

RpcNsEntryObjectInqDone-

RpcNsEntryObjectInqNext-

  • Last updated on