Tbsi_Create_Attestation_From_Log function

Creates an attestation by extracting a TrustPoint from a TCG log.

Syntax


NTSTATUS WINAPI Tbsi_Create_Attestation_From_Log(
  _In_reads_(cbLog) PBYTE pbLog,
  UINT32 cbLog,
  _In_opt_z_ PWSTR szAikNameRequested,
  _Outptr_opt_result_z_ PWSTR* pszAikName,
  _Out_writes_all_opt_(20) PBYTE pbAikPubDigest,
  _Out_writes_to_opt_(cbOutput, *pcbResult) PBYTE pbOutput,
  UINT32 cbOutput,
  _Out_  PUINT32 pcbResult,
  UINT32 dwFlags
);

Parameters

pbLog

A pointer to a buffer containing a TCG log.

cbLog

The size in bytes of the log specified by the pbLog parameter.

szAikNameRequested

If there are multiple AIKs registered (for example, using the NCryptExportKey function), this is a pointer to a WCHAR string of the name of the AIK for which to fetch the TrustPoint. If the specified AIK is not found, ERROR_INVALID_PARAMETER is returned. If this optional parameter is NULL, the first TrustPoint (if any) is retrieved from the log.

pszAikName

An optional pointer to a PWSTR variable that receives a pointer to a WCHAR string of the name of the AIK for which the TrustPoint was fetched. If this is NULL, the name is not returned.

pbAikPubDigest

An optional pointer to a 20 byte array to receive the SHA1 hash of the public modulus of the AIK for which the TrustPoint was fetched. If this is NULL, the hash is not returned.

pbOutput

A pointer to the buffer to receive the TrustPoint from the TCG log (if any).

cbOutput

The size in bytes of the buffer at pbOutput.

pcbResult [out]

A pointer to a UINT32 variable to receive the number of bytes written to the buffer, or the size of the buffer required.

dwFlags

No flags defined (0).

Remarks

The first TrustPoint, or the TrustPoint specified by the szAikNameRequested parameter, is extracted from the TCG log passed at the value specified by the pbLog parameter and returned in the buffer passed in the pbOutput parameter. If the pszAikName parameter is specified, it receives a pointer to the name of the AIK for which the TrustPoint is retrieved. If the pbAikPubDigest parameter is specified, it receives the SHA1 hash of the public modulus of the AIK for which the TrustPoint is retrieved.

Requirements

Header

Tbs.h

Library

Tbs.lib

DLL

Tbs.dll

See also

TBS Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft