RpcServerInqDefaultPrincNameW-Funktion (rpcdce.h)

Artikel
11/20/2024

Die RpcServerInqDefaultPrincName Funktion ruft den Standardprinzipalnamen für einen bestimmten Authentifizierungsdienst ab.

Syntax

RPC_STATUS RpcServerInqDefaultPrincNameW(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

Parameter

AuthnSvc

Authentifizierungsdienst, der verwendet werden soll, wenn der Server eine Anforderung für einen Remoteprozeduraufruf empfängt.

PrincName

Enthält bei Erfolg den Standardprinzipalnamen für den angegebenen Authentifizierungsdienst, wie durch den AuthnSvc Parameter angegeben. Der verwendete Authentifizierungsdienst definiert den Inhalt des Namens und dessen Syntax. Dieser Prinzipalname muss als ServerPrincName Parameter der RpcServerRegisterAuthInfo-Funktion verwendet werden. Wenn die Funktion erfolgreich ist, muss PrincName- mithilfe der funktion RpcStringFree freigegeben werden. Wenn die Funktion fehlschlägt, ist der Inhalt PrincName nicht definiert, und der Aufrufer ist nicht verpflichtet, sie frei zu geben.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_OUT_OF_MEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.

Hinweis Eine Liste gültiger Fehlercodes finden Sie unter RPC-Rückgabewerte.

Bemerkungen

Diese Funktion ist die empfohlene Methode, um den Serverprinzipalnamen abzurufen, der an die RpcServerRegisterAuthInfo-Funktion übergeben werden soll. Das Verfassen des Serverprinzipalnamens ist zwar möglich, ohne diese Funktion zu verwenden, aber das Aufrufen der Funktion ist für betriebssystemübergreifende Versionen einfacher und portierbarer.

Anmerkung

Der rpcdce.h-Header definiert RpcServerInqDefaultPrincName 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-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll

Siehe auch

RpcBindingSetAuthInfo-

RpcServerRegisterAuthInfo-

Freigeben über