Метод TakeOwnership класса Win32_Tpm
Метод TakeOwnership класса Win32_Tpm устанавливает владельца для доверенного платформенного модуля. Владелец доверенного платформенного модуля может в полной мере использовать возможности доверенного платформенного модуля. После установки владельца никакие другие пользователи или программное обеспечение не могут претендовать на владение доверенным платформенный модуль.
Методы IsEnabled, IsActivated и IsOwnershipAllowed должны иметь значение true, прежде чем метод TakeOwnership сможет успешно выполниться.
Синтаксис
uint32 TakeOwnership(
[in, optional] string OwnerAuth
);
Параметры
-
OwnerAuth [in, необязательный]
-
Тип: string
Строка, определяющая владельца доверенного платформенного модуля. Эта строка должна быть строкой в кодировке Base64, завершающейся нулевым значением, которая содержит ровно 20 байт двоичных данных. Используйте метод ConvertToOwnerAuth , чтобы преобразовать парольную фразу в этот ожидаемый формат. Параметр OwnerAuth считывается из реестра, если он не указан.
Возвращаемое значение
Тип: uint32
Можно вернуть все ошибки доверенного платформенного модуля, а также ошибки, относящиеся к базовым службам TPM.
В следующей таблице перечислены некоторые распространенные коды возврата.
Возвращаемый код/значение | Описание |
---|---|
|
Метод выполнен успешно. |
|
Недопустимый параметр OwnerAuth . |
|
Владелец уже существует в TPM. |
|
Ключ подтверждения в доверенном платформенный модуль не найден. Чтобы создать пару ключей подтверждения в TPM, см. метод CreateEndorsementKeyPair . |
|
Владелец не может быть установлен в этом доверенном платформенный модуль. Сведения о том, как разрешить установку владельца устройства, см. в разделе SetPhysicalPresenceRequest. |
|
TPM защищается от атак по словарю и находится в период ожидания. Дополнительные сведения см. в разделе Метод ResetAuthLockOut . |
Комментарии
Методы IsEnabled, IsActivated и IsOwnershipAllowed должны быть истинными, прежде чем TakeOwnership сможет успешно завершиться.
Чтобы изменить парольную фразу на входное значение, используемое для параметра OwnerAuth, следует использовать метод ConvertToOwnerAuth.
Метод TakeOwnership выполняет резервное копирование значения авторизации владельца в Active Directory, если настроены соответствующие параметры групповая политика.
MOF-файлы содержат определения для классов инструментария управления Windows (WMI). MOF-файлы не устанавливаются в составе пакета Windows SDK. Они устанавливаются на сервере при добавлении связанной роли с помощью диспетчер сервера. Дополнительные сведения о MOF-файлах см. в разделе Формат управляемого объекта (MOF).
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista [только классические приложения] |
Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
Пространство имен |
Root\CIMV2\Security\MicrosoftTpm |
MOF |
|
DLL |
|
См. также раздел