LsaRetrievePrivateData 函数 (ntsecapi.h)

  • 项目

请勿使用 LSA 专用数据函数。 请改用 CryptProtectData 和 CryptUnprotectData 函数。

语法

NTSTATUS LsaRetrievePrivateData(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING KeyName,
  [out] PLSA_UNICODE_STRING *PrivateData
);

参数

[in] PolicyHandle

Policy 对象的句柄。 句柄必须具有POLICY_GET_PRIVATE_INFORMATION访问权限。 有关详细信息，请参阅 打开策略对象句柄。

[in] KeyName

指向包含存储专用数据的密钥名称的 LSA_UNICODE_STRING 结构的指针。

若要创建专用对象，请将以下前缀之一添加到密钥名称。

前缀 含义
L$
 对于本地对象。
G$
 对于全局对象。
M$
 对于计算机对象。
 

如果不创建这些专用类型之一，则无需指定键名称前缀。 有关详细信息，请参阅 专用数据对象。

[out] PrivateData

指向接收指向包含专用数据的 LSA_UNICODE_STRING 结构的指针的变量的指针。

如果不再需要这些信息，请将返回的指针传递给 LsaFreeMemory。

返回值

如果函数成功，该函数将返回STATUS_SUCCESS。

如果函数失败，它将返回 NTSTATUS 值，该值可以是以下值或 LSA 策略函数返回值之一。

返回代码 说明
STATUS_OBJECT_NAME_NOT_FOUND
 KeyName 参数指定的名称下不存储专用数据。
 

可以使用 LsaNtStatusToWinError 函数将 NTSTATUS 值转换为 Windows 错误代码。

注解

必须运行此过程“作为管理员”，否则调用失败并ERROR_ACCESS_DENIED。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll

请参阅

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData