KERB_RETRIEVE_TKT_REQUEST 構造体 (ntsecapi.h)

KERB_RETRIEVE_TKT_REQUEST構造体には、チケットの取得に使用される情報が含まれています。

LsaCallAuthenticationPackage によって使用されます。Kerberos チケットは、インターネット RFC 4120 で定義されています。 詳細については、「http://www.ietf.org」を参照してください。

構文

typedef struct _KERB_RETRIEVE_TKT_REQUEST {
  KERB_PROTOCOL_MESSAGE_TYPE MessageType;
  LUID                       LogonId;
  UNICODE_STRING             TargetName;
  ULONG                      TicketFlags;
  ULONG                      CacheOptions;
  LONG                       EncryptionType;
  SecHandle                  CredentialsHandle;
} KERB_RETRIEVE_TKT_REQUEST, *PKERB_RETRIEVE_TKT_REQUEST;

メンバー

MessageType

KERB_PROTOCOL_MESSAGE_TYPE 要求の種類を示す値です。 このメンバーは KerbRetrieveEncodedTicketMessage に設定する必要があります。

LogonId

ログオン セッション識別子を含む LUID 構造体。 これは、現在のユーザーのログオン セッションの場合は 0 にすることができます。 ゼロでない場合、呼び出し元には SeTcbPrivilege 特権セットが必要です。 これが失敗した場合、Kerberos 認証パッケージは LsaCallAuthenticationPackage の ProtocolStatus パラメーターをSTATUS_ACCESS_DENIEDに設定します。

TargetName

ターゲット サービスの名前を含むUNICODE_STRING。

TicketFlags

取得したチケットの用途を指定するフラグが含まれます。 TicketFlags が 0 に設定されていて、キャッシュに一致するチケットが見つかった場合は、そのフラグ値に関係なく、そのチケットが返されます。 キャッシュに一致するものがない場合は、既定のフラグ値を持つ新しいチケットが要求されます。

このメンバーが 0 に設定されていない場合、返されたチケットはキャッシュされません。

CacheOptions

キャッシュを検索するためのオプションを示します。 キャッシュを検索する必要があることを示し、チケットが見つからない場合は、新しいチケットを要求する必要があることを示すには、このメンバーを 0 に設定します。

このメンバーが 0 に設定されていない場合、返されたチケットはキャッシュされません。

CacheOptions には、 次の値を含めることができます。

EncryptionType

要求されたチケットに使用する暗号化の種類を指定します。 このメンバーが 0 に設定されていない場合、返されたチケットはキャッシュされません。

このメンバーには、次のいずれかの値を指定できます。

CredentialsHandle

ログオン セッション識別子の代わりに使用される SSPI 資格情報ハンドル。

要件