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, optional]

요청된 보안 설명자의 복사본을 수신하는 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpcbSecurityDescriptor [in, out]

pSecurityDescriptor 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 변수에 대한 포인터입니다. 함수가 반환되면 변수에는 버퍼에 기록된 바이트 수가 포함됩니다.

반환 값

함수가 성공하면 함수는 ERROR_SUCCESS 반환합니다.

함수가 실패하면 Winerror.h에 정의된 0이 아닌 오류 코드를 반환합니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.

pSecurityDescriptor 매개 변수로 지정된 버퍼가 너무 작으면 함수는 ERROR_INSUFFICIENT_BUFFER 반환하고 lpcbSecurityDescriptor 매개 변수에는 요청된 보안 설명자에 필요한 바이트 수가 포함됩니다.

요구 사항

요구 사항	값
재배포 가능 파일	Windows 오프라인 레지스트리 라이브러리 버전 1.0 이상
헤더	Offreg.h
DLL	Offreg.dll

추가 정보

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION