ORGetKeySecurity 函式

擷取保護離線登錄區中指定之開啟登錄機碼之安全描述元的複本。

語法

DWORD ORGetKeySecurity(
  _In_      ORHKEY               Handle,
  _In_      SECURITY_INFORMATION SecurityInformation,
  _Out_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Inout_   PDWORD               lpcbSecurityDescriptor
);

參數

處理 [in]

離線登錄區中開啟登錄機碼的控制碼。

SecurityInformation [in]

SECURITY_INFORMATION值，指出所要求的安全性資訊。

pSecurityDescriptor [out， 選擇性]

緩衝區的指標，接收所要求之安全描述元的複本。 此參數可以是 Null。

lSecurityDescriptor [in， out]

變數的指標，指定 pSecurityDescriptor 參數所指向緩衝區的大小，以位元組為單位。 當函式傳回時，變數會包含寫入緩衝區的位元組數目。

傳回值

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

如果函式失敗，它會傳回 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。

如果 pSecurityDescriptor 參數指定的緩衝區太小，則函式會傳回ERROR_INSUFFICIENT_BUFFER， 而 lkbSecurityDescriptor 參數包含要求之安全性描述元所需的位元組數目。

規格需求

需求	值
可轉散發套件	Windows 離線登錄程式庫 1.0 版或更新版本
標頭	Offreg.h
DLL	Offreg.dll

另請參閱

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION