ConvertToOwnerAuth-Methode der Win32_Tpm-Klasse

Die ConvertToOwnerAuth-Methode der Win32_Tpm-Klasse übersetzt eine vom Benutzer bereitgestellte Passphraseeingabe in eine 20-Byte-Besitzerautorisierung, die für die Interaktion mit dem TPM verwendet werden kann. Methoden wie TakeOwnership und ResetAuthLockOut erfordern den resultierenden Besitzerautorisierungswert.

Der Konvertierungsprozess folgt den Spezifikationen der Trusted Computing Group.

Syntax

uint32 ConvertToOwnerAuth(
  [in]  string OwnerPassPhrase,
  [out] string OwnerAuth
);

Parameter

OwnerPassPhrase [in]

Typ: Zeichenfolge

Eine Zeichenfolge, die in einen Besitzerautorisierungswert konvertiert werden soll. Die Zeichenfolge kann eine beliebige Anzahl alphanumerischer Zeichen enthalten.

OwnerAuth [out]

Typ: Zeichenfolge

Eine vom OwnerPassPhrase-Parameter abgeleitete Zeichenfolge. Bei diesem Wert handelt es sich um einen binärwert von 20 Byte, der in eine base64-Zeichenfolge mit NULL-Termin codiert ist.

Rückgabewert

Typ: uint32

Alle TPM-Fehler sowie fehlerspezifisch für TPM-Basisdienste können zurückgegeben werden.

In den folgenden Tabellen sind einige der allgemeinen Rückgabecodes aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0 (0x0)	Die Methode war erfolgreich.

 

Bemerkungen

Eine unicode UTF-16LE-codierte Zeichenfolge wird in den 20-Byte-TPM-Besitzerautorisierungswert konvertiert, indem der SHA-1-Hash der binären Darstellung der Zeichenfolge verwendet wird. Die NULL-Beendigung der Unicode-Zeichenfolge ist nicht im Hash enthalten. Im SHA-1-Hash wird kein Salt verwendet.

Um beispielsweise die TPM-Besitzerpassphrase "1Sample" in einen TPM-Besitzerautorisierungswert zu konvertieren, wird der SHA-1-Hash aus dem folgenden Bytedatenstrom übernommen:

0x31 0x00 0x53 0x00 0x61 0x00 0x6D 0x00 0x70 0x00 0x6C 0x00 0x65 0x00

Um eine Passphrase der Länge Null in einen Autorisierungswert des Besitzers zu konvertieren, wird der SHA-1-Hash aus dem NULL-Bytestream übernommen.

MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Windows SDK installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe der Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Namespace	Root\CIMV2\Security\MicrosoftTpm
MOF	Win32_tpm.mof
DLL	Win32_tpm.dll

Siehe auch

Win32_Tpm

TakeOwnership