.\" Copyright (C) 2007 International Business Machines Corporation
.\" Written by Tom Lendacky based on the Trusted Computing Group Software Stack Specification Version 1.2
.\"
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "Tspi_DecodeBER_TssBlob" 3 "2007-06-12" "TSS 1.2" "TCG Software Stack Developer's Reference"
.SH NAME
Tspi_DecodeBER_TssBlob \- unwraps a BER-encoded TSS blob. 
.SH "SYNOPSIS"
.ad l
.hy 0
.nf
.B #include <tss/tspi.h>
.sp
.BI "TSS_RESULT Tspi_DecodeBER_TssBlob(UINT32  " berBlobSize ", BYTE*   " berBlob ","
.BI "                                  UINT32* " blobType ",    UINT32* " rawBlobSize ","
.BI "                                  BYTE*   " rawBlob ");"
.fi
.sp
.ad
.hy

.SH "DESCRIPTION"
.PP
\fBTspi_DecodeBER_TssBlob\fR  is used to unwrap a BER-encoded blob in accordance with the ASN.1 data definitions in the Portable Data section of the Trusted Computing Group Software Stack Specification Version 1.2.
.SH "PARAMETERS"
.PP
.SS berBlobSize
Size of the BER-encoded blob.
.PP
.SS berBlob
Pointer to the BER-encoded blob.
.PP
.SS blobType
Pointer to the type of blob being unwrapped (refer to the TSS_BLOB_TYPE_* constants).
.PP
.SS rawBlobSize
Pointer to the size of the rawBlob buffer.  On input this parameter contains a pointer to the maximum size of the supplied rawBlob buffer.  On output this parameter contains a pointer to the actual size of the unwrapped blob.  On input, if this parameter points to a value of 0, then this function will return the size of the buffer required to hold the unwrapped blob without writing to the rawBlob buffer.
.sp
\fBNote:\fR The output data must be shorter than the BER-encoding, so berBlobSize is a useful upper limit on rawBlob buffer size.
.PP
.SS rawBlob
Pointer to a buffer to hold the unwrapped blob.
.SH "RETURN CODES"
.PP
\fBTspi_EncodeDER_TssBlob\fR returns TSS_SUCCESS on success, otherwise one of the following values are returned:
.TP
.SM TSS_E_BAD_PARAMETER
.TP
.SM TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.
.SH "CONFORMING TO"

.PP
\fBTspi_DecodeBER_TssBlob\fR conforms to the Trusted Computing Group Software Specification Version 1.2
.SH "SEE ALSO"

.PP
\fBTspi_DecodeBER_TssBlob\fR(3).