RpcBindingInqAuthInfoExA-Funktion (rpcdce.h)
Die RpcBindingInqAuthInfoEx-Funktion gibt Authentifizierungs-, Autorisierungs- und Sicherheitsqualitätsinformationen aus einem Bindungshandle zurück.
Syntax
RPC_STATUS RpcBindingInqAuthInfoExA(
RPC_BINDING_HANDLE Binding,
RPC_CSTR *ServerPrincName,
unsigned long *AuthnLevel,
unsigned long *AuthnSvc,
RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
unsigned long *AuthzSvc,
unsigned long RpcQosVersion,
RPC_SECURITY_QOS *SecurityQOS
);
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 RpcBindingInqAuthInfoEx 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. Eine Liste der RPC-unterstützten Authentifizierungsstufen finden Sie unter Konstanten auf Authentifizierungsebene. Geben Sie einen NULL-Wert an, um zu verhindern, dass die Funktion den AuthnLevel-Parameter zurückgibt .
Die im Parameter AuthnLevel zurückgegebene Ebene unterscheidet sich möglicherweise von der Ebene, die angegeben wurde, als der Client die RpcBindingSetAuthInfoEx-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. Eine Liste der von RPC unterstützten Authentifizierungsdienste finden Sie unter Authentication-Service Constants.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcBindingInqAuthInfoEx 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 RpcBindingInqAuthInfoEx 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 Bindung durchgeführt hat. Eine Liste der von RPC unterstützten Authentifizierungsdienste finden Sie unter Authentication-Service Constants.
Geben Sie einen NULL-Wert an, um zu verhindern , dass RpcBindingInqAuthInfoEx den AuthzSvc-Parameter zurückgibt.
RpcQosVersion
Übergibt den Wert der aktuellen Version (erforderlich für die Vorwärtskompatibilität, wenn Erweiterungen für diese Funktion vorgenommen werden). Legen Sie diesen Parameter immer auf RPC_C_SECURITY_QOS_VERSION fest.
SecurityQOS
Gibt den Zeiger auf die RPC_SECURITY_QOS-Struktur zurück, die Quality-of-Service-Einstellungen definiert.
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 RpcBindingInqAuthInfoEx-Funktion auf, um die Authentifizierungs- und Autorisierungsinformationen anzuzeigen, die einem Serverbindungshandle zugeordnet sind. Diese Funktion bietet die Möglichkeit, die Sicherheitsqualität des Diensts für den Bindungshandle zu erfragen. Sie ist andernfalls mit RpcBindingInqAuthInfo identisch.
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 RpcBindingInqAuthInfoEx 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 [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 |