Condividi tramite

KERB_PURGE_TKT_CACHE_REQUEST struttura (ntsecapi.h)

  • Articolo

La struttura KERB_PURGE_TKT_CACHE_REQUEST contiene informazioni usate per eliminare le voci dalla cache dei ticket.

Viene usato da LsaCallAuthenticationPackage.

Sintassi

typedef struct _KERB_PURGE_TKT_CACHE_REQUEST {
  KERB_PROTOCOL_MESSAGE_TYPE MessageType;
  LUID                       LogonId;
  UNICODE_STRING             ServerName;
  UNICODE_STRING             RealmName;
} KERB_PURGE_TKT_CACHE_REQUEST, *PKERB_PURGE_TKT_CACHE_REQUEST;

Members

MessageType

KERB_PROTOCOL_MESSAGE_TYPE valore che identifica il tipo di richiesta da effettuare. Questo membro deve essere impostato su KerbPurgeTicketCacheMessage.

LogonId

Struttura LUID contenente l'identificatore di sessione di accesso. Questo può essere zero per la sessione di accesso dell'utente corrente. Se non zero, il chiamante deve avere il privilegio SeTcbPrivilege impostato. In caso contrario, il pacchetto di autenticazione Kerberos imposta il parametro ProtocolStatus di LsaCallAuthenticationPackage su STATUS_ACCESS_DENIED.

ServerName

UNICODE_STRING contenente il nome del servizio i cui ticket devono essere eliminati dalla cache.

RealmName

UNICODE_STRING contenente il nome dell'area di autenticazione i cui ticket devono essere eliminati dalla cache.

Commenti

Se sia ServerName che RealmName sono di lunghezza zero, LsaCallAuthenticationPackage eliminerà tutti i ticket per la sessione di accesso identificata da LogonId. In caso contrario, LsaCallAuthenticationPackage cercherà i ticket della cache per ServerName RealmName@ e eliminerà tutti questi ticket.

LsaCallAuthenticationPackage non restituisce questo buffer. Restituisce STATUS_SUCCESS se viene eliminato uno o più ticket. Se non vengono trovati ticket, la funzione restituisce SEC_E_NO_CREDENTIALS.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione ntsecapi.h