Manual Pages for UNIX Operating System command usage for man Tspi_Policy_SetSecret

Introduction to Library Functions        Tspi_Policy_SetSecret(3)



NAME
     Tspi_Policy_SetSecret - set the authorization data of a pol-
     icy object and define the handling of its retrieval

SYNOPSIS
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 

     TSS_RESULT Tspi_Policy_SetSecret(TSS_HPOLICY hPolicy,        TSS_FLAG secretMode,
                                      UINT32      ulSecretLength, BYTE*    rgbSecret);



DESCRIPTION
     TSS_Policy_SetSecret sets the authorization data for an  ob-
     ject.  This  mthod also defines the handling of its retriev-
     ing. There are mand different  paths  as  specified  by  the
     secretMode Flag.

PARAMETERS
  hPolicy
     The handle of the policy object.

  secretMode
     Flag indicating the policy  secret  mode  to  set.  Possible
     values are:
      TSS_SECRET_MODE_SHA1 - Secret in the form of  20  bytes  of
     SHA-1 data. The secret will not be touched by the TSP.
      TSS_SECRET_MODE_PLAIN - The data passed in will  be  hashed
     by the TSP using SHA-1.
      TSS_SECRET_MODE_POPUP - The TSP will ask for  a  secret  by
     displaying a GUI pop-up window.
      TSS_SECRET_MODE_CALLBACK - The application will  provide  a
     callback function for authorization data.
      TSS_SECRET_MODE_NONE - ulSecretLen and  rgbSecret  are  ig-
     nored  and  any  object  requiring auth assigned this policy
     will return an error.

  ulSecretLength
     The length (in bytes) of the rgbSecret parameter.

  rgbSecret
     The secret data blob.

RETURN CODES
     Tspi_Policy_SetSecret returns TSS_SUCCESS on success, other-
     wise one of the following values are returned:



TSS 1.1              Last change: 2004-05-26                    1






Introduction to Library Functions        Tspi_Policy_SetSecret(3)



     TSS_E_INVALID_HANDLE - hPolicy is an invalid

     TSS_E_INTERNAL_ERROR - An error occurred internal

CONFORMING TO
     Tspi_Policy_SetSecret  conforms  to  the  Trusted  Computing
     Group Software Specification version 1.1 Golden

SEE ALSO
     Tspi_Policy_FlushSecret(3).

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     __________________________________________________
    |   ATTRIBUTE TYPE   |       ATTRIBUTE VALUE      |
    |____________________|_____________________________|_
    | Availability       |  library/security/trousers |
    |____________________|_____________________________|_
    | Interface Stability|  Uncommitted               |
    |____________________|____________________________|

NOTES
     Source for trousers is available  at  http://opensolaris.org
     and at http://sourceforge.net/projects/trousers.  Documenta-
     tion   is   available    at    file:///usr/share/man,    and
     http://sourceforge.net/projects/trousers.



























TSS 1.1              Last change: 2004-05-26                    2