RpcBindingInqAuthInfoA-Funktion (rpcdce.h)

Die RpcBindingInqAuthInfo Funktion gibt Authentifizierungs- und Autorisierungsinformationen aus einem Bindungshandle zurück.

Syntax

RPC_STATUS RpcBindingInqAuthInfoA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

Parameter

Binding

Serverbindungshandle, von dem Authentifizierungs- und Autorisierungsinformationen zurückgegeben werden.

ServerPrincName

Gibt einen Zeiger auf einen Zeiger auf den erwarteten Prinzipalnamen des Servers zurück, auf den in Bindingverwiesen wird. Der Inhalt des zurückgegebenen Namens und deren Syntax werden vom verwendeten Authentifizierungsdienst definiert.

Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcBindingInqAuthInfo den ServerPrincName Parameter zurückgibt. In diesem Fall ruft die Anwendung die funktion RpcStringFree nicht auf.

AuthnLevel

Gibt einen Zeiger zurück, der auf die Authentifizierungsebene festgelegt ist, die für Remoteprozeduraufrufe verwendet wird, die mit Bindingausgeführt werden. Siehe Hinweis.

Geben Sie einen NULL-Wert an, um zu verhindern, dass die Funktion den AuthnLevel Parameter zurückgibt.

Die im AuthnLevel--Parameter zurückgegebene Ebene unterscheidet sich möglicherweise von der Ebene, die angegeben wird, wenn der Client die RpcBindingSetAuthInfo Funktion aufgerufen hat. Diese Diskrepanz tritt auf, wenn die RPC-Laufzeitbibliothek die vom Client angegebene Authentifizierungsebene nicht unterstützt und automatisch auf die nächste höhere Authentifizierungsebene aktualisiert wird.

AuthnSvc

Gibt einen Zeiger zurück, der auf den für Remoteprozeduraufrufe angegebenen Authentifizierungsdienst mit Bindingfestgelegt ist. Siehe Hinweis.

Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcBindingInqAuthInfo- den AuthnSvc--Parameter zurückgibt.

AuthIdentity

Gibt einen Zeiger auf ein Handle auf die Datenstruktur zurück, die die Authentifizierungs- und Autorisierungsanmeldeinformationen des Clients enthält, die für Remoteprozeduraufrufe angegeben sind, die mit Bindingausgeführt werden.

Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcBindingInqAuthInfo- den AuthIdentity--Parameter zurückgibt.

AuthzSvc

Gibt einen Zeiger zurück, der auf den von der Clientanwendung angeforderten Autorisierungsdienst festgelegt ist, der den Remoteprozeduraufruf für Binding Siehe Hinweis.

Geben Sie einen NULL-Wert an, um zu verhindern, dass RpcBindingInqAuthInfo- den AuthzSvc--Parameter zurückgibt.

Hinweis Eine Liste der vom RPC unterstützten Authentifizierungsdienste finden Sie unter Authentication-Service Konstanten.

 

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_BINDING	Das Bindungshandle war ungültig.
RPC_S_WRONG_KIND_OF_BINDING	Dies war die falsche Art von Bindung für den Vorgang.
RPC_BINDING_HAS_NO_AUTH	Die Bindung enthält keine Authentifizierungsinformationen.

 

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

 

Bemerkungen

Eine Clientanwendung ruft die RpcBindingInqAuthInfo Funktion auf, um die Authentifizierungs- und Autorisierungsinformationen anzuzeigen, die einem Serverbindungshandle zugeordnet sind. Eine ähnliche Funktion, RpcBindingInqAuthInfoEx bietet zusätzlich Informationen zur Sicherheitsqualität des Diensts zum Bindungshandle.

Die RPC-Laufzeitbibliothek weist Speicher für den zurückgegebenen ServerPrincName Parameter zu. Die Anwendung ist dafür verantwortlich, die RpcStringFree--Funktion für diese zurückgegebene Argumentzeichenfolge aufzurufen.

Anmerkung

Der rpcdce.h-Header definiert RpcBindingInqAuthInfo 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 [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform-	Fenster
Header-	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
DLL-	Rpcrt4.dll

Siehe auch

RpcBindingInqAuthClient-

RpcBindingInqAuthInfoEx-

RpcBindingInqOption-

RpcBindingSetAuthInfo-

RpcStringFree-