KERB_PURGE_TKT_CACHE_REQUEST 結構 (ntsecapi.h)

KERB_PURGE_TKT_CACHE_REQUEST 結構包含用來從票證快取中刪除項目的資訊。

LsaCallAuthenticationPackage 會使用它。

語法

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;

成員

MessageType

KERB_PROTOCOL_MESSAGE_TYPE 識別所提出要求類型的值。 此成員必須設定為 KerbPurgeTicketCacheMessage。

LogonId

包含登入會話標識碼的 LUID 結構。 對於目前使用者的登入會話，這可以是零。 如果不是零，呼叫端必須設定 SeTcbPrivilege 許可權。 如果失敗，Kerberos 驗證套件會將 LsaCallAuthenticationPackage 的 ProtocolStatus 參數設定為 STATUS_ACCESS_DENIED。

ServerName

UNICODE_STRING 包含應該從快取中刪除其票證的服務名稱。

RealmName

UNICODE_STRING 包含應該從快取中刪除其票證的領域名稱。

備註

如果 ServerName 和 RealmName 的長度為零， LsaCallAuthenticationPackage 將會刪除 LogonId 所識別之登入會話的所有票證。 否則， LsaCallAuthenticationPackage 會搜尋 ServerName@RealmName 的快取票證，並刪除所有這類票證。

LsaCallAuthenticationPackage 不會傳回此緩衝區。 如果刪除一或多個票證，它會傳回STATUS_SUCCESS。 如果找不到任何票證，函式會傳回SEC_E_NO_CREDENTIALS。

規格需求