Funzione RpcBindingInqAuthInfoExA (rpcdce.h)
La funzione RpcBindingInqAuthInfoEx restituisce l'autenticazione, l'autorizzazione e le informazioni sulla qualità del servizio da un handle di associazione.
Sintassi
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
);
Parametri
Binding
Handle di associazione server da cui vengono restituite le informazioni di autenticazione e autorizzazione.
ServerPrincName
Restituisce un puntatore a un puntatore al nome dell'entità previsto del server a cui fa riferimento in Binding. Il contenuto del nome restituito e la relativa sintassi sono definiti dal servizio di autenticazione in uso.
Specificare un valore Null per impedire a RpcBindingInqAuthInfoEx di restituire il parametro ServerPrincName . In questo caso, l'applicazione non chiama la funzione RpcStringFree .
AuthnLevel
Restituisce un puntatore impostato sul livello di autenticazione usato per le chiamate di routine remote effettuate tramite Binding. Per un elenco dei livelli di autenticazione supportati da RPC, vedere Costanti a livello di autenticazione. Specificare un valore Null per impedire alla funzione di restituire il parametro AuthnLevel .
Il livello restituito nel parametro AuthnLevel può essere diverso dal livello specificato quando il client ha chiamato la funzione RpcBindingSetAuthInfoEx . Questa discrepanza si verifica quando la libreria di runtime RPC non supporta il livello di autenticazione specificato dal client e esegue automaticamente l'aggiornamento al livello di autenticazione successivo superiore.
AuthnSvc
Restituisce un puntatore impostato sul servizio di autenticazione specificato per le chiamate di routine remote effettuate tramite Binding. Per un elenco dei servizi di autenticazione supportati da RPC, vedere Costanti del servizio di autenticazione.
Specificare un valore Null per impedire a RpcBindingInqAuthInfoEx di restituire il parametro AuthnSvc .
AuthIdentity
Restituisce un puntatore a un handle alla struttura di dati che contiene le credenziali di autenticazione e autorizzazione del client specificate per le chiamate di routine remote effettuate tramite Binding.
Specificare un valore Null per impedire a RpcBindingInqAuthInfoEx di restituire il parametro AuthIdentity .
AuthzSvc
Restituisce un puntatore impostato sul servizio di autorizzazione richiesto dall'applicazione client che ha effettuato la chiamata alla procedura remota su Binding. Per un elenco dei servizi di autenticazione supportati da RPC, vedere Costanti del servizio di autenticazione.
Specificare un valore Null per impedire a RpcBindingInqAuthInfoEx di restituire il parametro AuthzSvc .
RpcQosVersion
Passa il valore della versione corrente (necessaria per la compatibilità con l'inoltro se le estensioni vengono apportate a questa funzione). Impostare sempre questo parametro su RPC_C_SECURITY_QOS_VERSION.
SecurityQOS
Restituisce il puntatore alla struttura RPC_SECURITY_QOS , che definisce le impostazioni di qualità del servizio.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
L'handle di associazione non è valido. |
|
Questo è stato il tipo di associazione sbagliato per l'operazione. |
|
L'associazione non dispone di informazioni di autenticazione. |
Commenti
Un'applicazione client chiama la funzione RpcBindingInqAuthInfoEx per visualizzare le informazioni di autenticazione e autorizzazione associate a un handle di associazione server. Questa funzione offre la possibilità di verificare la qualità della sicurezza del servizio nell'handle di associazione. In caso contrario, è identico a RpcBindingInqAuthInfo.
La libreria di runtime RPC alloca la memoria per il parametro ServerPrincName restituito. L'applicazione è responsabile della chiamata alla funzione RpcStringFree per la stringa di argomento restituita.
Nota
L'intestazione rpcdce.h definisce RpcBindingInqAuthInfoEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcdce.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |