RpcNsBindingInqEntryNameW-Funktion (rpcdce.h)
Die RpcNsBindingInqEntryName-Funktion gibt den Eintragsnamen zurück, von dem das Bindungshandle stammt.
Syntax
RPC_STATUS RpcNsBindingInqEntryNameW(
RPC_BINDING_HANDLE Binding,
unsigned long EntryNameSyntax,
RPC_WSTR *EntryName
);
Parameter
Binding
Bindungshandle, dessen Name-Dienst-Datenbankeintragsname zurückgegeben wird.
EntryNameSyntax
Syntax, die in EntryName verwendet wird.
So verwenden Sie die im Registrierungswerteintrag angegebene Syntax
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxgeben Sie den Wert RPC_C_NS_SYNTAX_DEFAULT an.
EntryName
Gibt die Adresse eines Zeigers auf den Namen des Datenbankeintrags name-service zurück, in dem Binding gefunden wurde.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcNsBindingInqEntryName den EntryName-Parameter zurückgibt. In diesem Fall ruft die Anwendung die RpcStringFree-Funktion nicht auf.
Rückgabewert
Wert | Bedeutung |
---|---|
|
Der Aufruf war erfolgreich. |
|
Das Bindungshandle war ungültig. |
|
Kein Eintragsname für die Bindung. |
|
Die Namenssyntax ist ungültig. |
|
Die Namenssyntax wird nicht unterstützt. |
|
Der Name ist unvollständig. |
Hinweise
Die RpcNsBindingInqEntryName-Funktion gibt den Namen des Namens service–database entry name zurück, aus dem ein clientkompatibles Bindungshandle stammt.
Die RPC-Laufzeitbibliothek weist Arbeitsspeicher für die im EntryName-Parameter zurückgegebene Zeichenfolge zu. Die Anwendung ist für den Aufruf der RpcStringFree-Funktion verantwortlich, um die Zuordnung dieses Arbeitsspeichers zu beheben.
Ein Eintragsname ist nur Bindungshandles zugeordnet, die von den Funktionen RpcNsBindingImportNext, RpcNsBindingLookupNext und RpcNsBindingSelect zurückgegeben werden.
Wenn das im Binding-Parameter angegebene Bindungshandle nicht von einem Name-Service-Datenbankeintrag zurückgegeben wurde (z. B. wenn das Bindungshandle durch Aufrufen von RpcBindingFromStringBinding erstellt wurde), gibt RpcNsBindingInqEntryName eine leere Zeichenfolge ("\0") und einen RPC_S_NO_ENTRY_NAME status Code zurück.
Hinweis
Der rpcdce.h-Header definiert RpcNsBindingInqEntryName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 | rpcdce.h (include Rpc.h) |
Bibliothek | Rpcrt4.lib |
DLL | Rpcrt4.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für