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 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 RpcBindingInqAuthInfoEx 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. Eine Liste der RPC-unterstützten Authentifizierungsstufen finden Sie unter Authentication-Level Konstanten. 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 funktion RpcBindingSetAuthInfoEx 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. Eine Liste der rpc-unterstützten Authentifizierungsdienste finden Sie unter Authentication-Service Konstanten.
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, 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 RpcBindingInqAuthInfoEx- 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 Bindingdurchgeführt hat. Eine Liste der rpc-unterstützten Authentifizierungsdienste finden Sie unter Authentication-Service Konstanten.
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 an dieser 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 Qualitätseinstellungen definiert.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art von Bindung für den Vorgang. |
|
Die Bindung enthält keine Authentifizierungsinformationen. |
Bemerkungen
Eine Clientanwendung ruft die funktion RpcBindingInqAuthInfoEx auf, um die Authentifizierungs- und Autorisierungsinformationen anzuzeigen, die einem Serverbindungshandle zugeordnet sind. Diese Funktion bietet die Möglichkeit, sich über die Sicherheitsqualität des Diensts im Bindungshandle zu informieren. Es ist andernfalls identisch mit RpcBindingInqAuthInfo.
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 RpcBindingInqAuthInfoEx 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 |