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
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING	Questo è stato il tipo di associazione sbagliato per l'operazione.
RPC_BINDING_HAS_NO_AUTH	L'associazione non dispone di informazioni di autenticazione.

 

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

 

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

Vedi anche

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx

RpcStringFree