LsaRetrievePrivateData 函式 (ntsecapi.h)

請勿使用 LSA 私人數據函式進行一般數據加密和解密。 請改用 CryptProtectData 和 CryptUnprotectData 函式。 只有在需要操作 LSA 秘密時，才使用 LSA 私人數據函式，如秘密對象數據模型中所述

語法

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$	針對計算機物件。

 

如果您未建立其中一個特製化類型，則不需要指定索引鍵名稱前置詞。 如需詳細資訊，請參閱 Private Data Object。

[out] PrivateData

接收包含私 用數據之LSA_UNICODE_STRING 結構指標的變數指標。

當您不再需要資訊時，請將傳回的指標傳遞至 LsaFreeMemory。

傳回值

如果函式成功，函式會傳回STATUS_SUCCESS。

如果函式失敗，它會傳回 NTSTATUS 值，可以是下列值或其中一個 LSA原則函數傳回值。

傳回碼	Description
STATUS_OBJECT_NAME_NOT_FOUND	KeyName 參數所指定的名稱下不會儲存任何私人數據。

 

您可以使用 LsaNtStatusToWinError 函 式，將 NTSTATUS 值轉換為 Windows 錯誤碼。

備註

您必須以系統管理員身分執行此程式，否則呼叫會因為ERROR_ACCESS_DENIED而失敗。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	ntsecapi.h
程式庫	Advapi32.lib
Dll	Advapi32.dll

另請參閱

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData