RpcBindingInqAuthInfoW-Funktion (rpcdce.h)
Die RpcBindingInqAuthInfo-Funktion gibt Authentifizierungs- und Autorisierungsinformationen aus einem Bindungshandle zurück.
Syntax
RPC_STATUS RpcBindingInqAuthInfoW(
RPC_BINDING_HANDLE Binding,
RPC_WSTR *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 Bindung verwiesen wird. Der Inhalt des zurückgegebenen Namens und seine 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 RpcStringFree-Funktion nicht auf.
AuthnLevel
Gibt einen Zeiger zurück, der auf die Authentifizierungsebene festgelegt ist, die für Remoteprozeduraufrufe mit Bindung verwendet wird. 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 wurde, 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ächst höhere Authentifizierungsebene aktualisiert wird.
AuthnSvc
Gibt einen Zeiger zurück, der auf den Authentifizierungsdienst festgelegt ist, der für Remoteprozeduraufrufe mit Bindung angegeben 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, das die Anmeldeinformationen für die Authentifizierung und Autorisierung des Clients enthält, die für Remoteprozeduraufrufe mit Bindung angegeben sind.
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 Autorisierungsdienst festgelegt ist, der von der Clientanwendung angefordert wurde, die den Remoteprozeduraufruf für bindungsseitig ausgeführt hat Siehe Hinweis.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcBindingInqAuthInfo den AuthzSvc-Parameter zurückgibt.
Rückgabewert
Wert | Bedeutung |
---|---|
|
Der Aufruf war erfolgreich. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art der Bindung für den Vorgang. |
|
Die Bindung enthält keine Authentifizierungsinformationen. |
Hinweise
Eine Clientanwendung ruft die RpcBindingInqAuthInfo-Funktion auf, um die Authentifizierungs- und Autorisierungsinformationen anzuzeigen, die einem Serverbindungshandle zugeordnet sind. Eine ähnliche Funktion, RpcBindingInqAuthInfoEx , stellt zusätzlich Sicherheitsinformationen zur Dienstqualität für das Bindungshandle bereit.
Die RPC-Laufzeitbibliothek weist Arbeitsspeicher für den zurückgegebenen ServerPrincName-Parameter zu. Die Anwendung ist dafür verantwortlich, die RpcStringFree-Funktion für diese zurückgegebene Argumentzeichenfolge aufzurufen.
Hinweis
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 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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-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