ORQueryInfoKey 함수

오프라인 레지스트리 하이브에서 지정된 레지스트리 키에 대한 정보를 검색합니다.

구문

DWORD ORQueryInfoKey(
  _In_        ORHKEY    Handle,
  _Out_opt_   PWSTR     lpClass,
  _Inout_opt_ PDWORD    lpcClass,
  _Out_opt_   PDWORD    lpcSubKeys,
  _Out_opt_   PDWORD    lpcMaxSubKeyLen,
  _Out_opt_   PDWORD    lpcMaxClassLen,
  _Out_opt_   PDWORD    lpcValues,
  _Out_opt_   PDWORD    lpcMaxValueNameLen,
  _Out_opt_   PDWORD    lpcMaxValueLen,
  _Out_opt_   PDWORD    lpcbSecurityDescriptor,
  _Out_opt_   PFILETIME lpftLastWriteTime
);

매개 변수

핸들 [in]

오프라인 레지스트리 하이브에서 열린 레지스트리 키에 대한 핸들입니다.

lpClass [out, optional]

키 클래스를 수신하는 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpcClass [in, out, optional]

lpClass 매개 변수가 가리키는 버퍼의 크기를 문자 단위로 지정하는 변수에 대한 포인터입니다.

크기에는 종료 null 문자가 포함되어야 합니다. 함수가 반환되면 이 변수는 버퍼에 저장된 클래스 문자열의 크기를 포함합니다. 반환된 개수에는 종료 null 문자가 포함되지 않습니다. 버퍼가 충분히 크지 않으면 함수는 ERROR_MORE_DATA 반환하고, 변수는 종료 null 문자를 계산하지 않고 문자열의 크기를 문자 단위로 포함합니다.

lpClass가 NULL인 경우 lpcClass는 NULL일 수 있습니다.

lpClass 매개 변수가 유효한 주소이지만 lpcClass 매개 변수가 아닌 경우(예: lpcClass 매개 변수가 NULL인 경우) 함수는 ERROR_INVALID_PARAMETER 반환합니다.

lpcSubKeys [out, optional]

지정된 키에 포함된 하위 키 수를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpcMaxSubKeyLen [out, optional]

종결 null 문자를 포함하지 않고 유니코드 문자에서 가장 긴 이름의 키 하위 키 크기를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpcMaxClassLen [out, optional]

하위 키 클래스를 지정하는 가장 긴 문자열의 크기를 유니코드 문자로 받는 변수에 대한 포인터입니다. 반환된 개수에는 종료 null 문자가 포함되지 않습니다. 이 매개 변수는 NULL일 수 있습니다.

lpcValues [out, optional]

키와 연결된 값 수를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpcMaxValueNameLen [out, optional]

키의 가장 긴 값 이름(유니코드 문자)의 크기를 받는 변수에 대한 포인터입니다. 크기는 종료 null 문자를 포함하지 않습니다. 이 매개 변수는 NULL일 수 있습니다.

lpcMaxValueLen [out, optional]

키 값 중 가장 긴 데이터 구성 요소의 크기를 바이트 단위로 받는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpcbSecurityDescriptor [out, optional]

키의 보안 설명자 크기를 바이트 단위로 받는 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

lpftLastWriteTime [out, optional]

마지막 쓰기 시간을 수신하는 FILETIME 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

함수는 FILETIME 구조체의 멤버를 설정하여 키 또는 해당 값 항목이 마지막으로 수정된 시간을 나타냅니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

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

lpClass 버퍼가 너무 작아서 클래스 이름을 받을 수 없다면 함수는 ERROR_MORE_DATA 반환합니다.

요구 사항

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

추가 정보

FILETIME

ORCreateKey

OROpenKey

ORDeleteKey