Funzione RpcBindingInqAuthInfo (rpcdce.h)

Articolo
08/25/2023

La funzione RpcBindingInqAuthInfo restituisce informazioni di autenticazione e autorizzazione da un handle di associazione.

Sintassi

RPC_STATUS RpcBindingInqAuthInfo(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

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 RpcBindingInqAuthInfo 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. Vedere la nota.

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 RpcBindingSetAuthInfo . Questa discrepanza si verifica quando la libreria di runtime RPC non supporta il livello di autenticazione specificato dal client e aggiorna automaticamente al livello di autenticazione successivo.

AuthnSvc

Restituisce un puntatore impostato sul servizio di autenticazione specificato per le chiamate di routine remote effettuate tramite Binding. Vedere la nota.

Specificare un valore Null per impedire a RpcBindingInqAuthInfo 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 RpcBindingInqAuthInfo 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 in Binding Vedere nota.

Specificare un valore Null per impedire a RpcBindingInqAuthInfo di restituire il parametro AuthzSvc .

Nota Per un elenco dei servizi di autenticazione supportati da RPC, vedere Costanti del servizio di autenticazione.

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 RpcBindingInqAuthInfo per visualizzare le informazioni di autenticazione e autorizzazione associate a un handle di associazione server. Una funzione simile, RpcBindingInqAuthInfoEx fornisce inoltre informazioni sulla qualità del servizio di sicurezza nell'handle di associazione.

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.

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

RpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree

Condividi tramite