Share via

PFSCE_QUERY_INFO 콜백 함수(scesvc.h)

  • 아티클

PFSCE_QUERY_INFO 콜백 함수는 보안 구성 파일 또는 분석 데이터베이스에서 서비스별 정보를 쿼리합니다.

구문

PFSCE_QUERY_INFO PfsceQueryInfo;

SCESTATUS PfsceQueryInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [out]          PVOID *ppvInfo,
  [out]          PSCE_ENUMERATION_CONTEXT psceEnumHandle
)
{...}

매개 변수

[in] sceHandle

형식: SCE_HANDLE

ISceSvcAttachmentData::Initialize를 호출하는 동안 보안 구성 도구 집합에서 첨부 파일에 전달된 불투명 핸들을 지정합니다. 이 핸들은 쿼리된 정보를 저장하는 데 사용됩니다.

[in] sceType

형식: SCESVC_INFO_TYPE

쿼리할 정보의 유형을 지정합니다. 다음 플래그 중 하나를 지정합니다.

값 의미
SCE_SERVICE_CONFIGURATION_INFO
 데이터베이스에서 구성 정보를 요청합니다.
SCE_SERVICE_ANALYSIS_INFO
 데이터베이스에서 분석 정보를 요청합니다.

[in, optional] lpPrefix

형식: LPTSTR

쿼리를 제한하기 위한 접두사 또는 키( bExact 참조)를 지정합니다. 문자열이 제공되면 문자열과 일치하는 키(및 해당 값)만 반환됩니다. NULL로 설정하면 모든 키가 반환됩니다.

[in] bExact

형식: BOOL

lpPrefix에서 제공하는 문자열을 특정 키 또는 접두사로 처리할지 여부를 지정합니다. lpPrefix가 NULL로 설정된 경우 이 매개 변수는 무시됩니다. 다음 값 중 하나를 지정합니다.

값 의미
TRUE
 lpPrefix에 지정된 문자열은 특정 키를 나타냅니다. 해당 키와 일치하는 레코드만 반환됩니다.
FALSE
 lpPrefix로 지정된 문자열은 접두사를 나타냅니다. 동일한 접두사를 가진 모든 키(및 해당 값)가 반환됩니다.

[out] ppvInfo

형식: PVOID*

다음 구조체 중 하나에 대한 포인터를 반환합니다. 보안 구성 도구 집합(첨부 파일이 아님)은 정보에 대한 버퍼를 할당합니다. 따라서 이 포인터는 NULL을 가리킵니다.

값 의미
SCESVC_CONFIGURATION_INFO
 sceType이 SCE_SERVICE_CONFIGURATION_INFO 설정되면
SCESVC_ANALYSIS_INFO
 sceType이 SCE_SERVICE_ANALYSIS_INFO 설정되면

[out] psceEnumHandle

형식: PSCE_ENUMERATION_CONTEXT

이 함수에 대한 연속 호출에 사용할 수 있는 핸들을 반환합니다. 존재할 수 있는 키가 많기 때문에 모든 키가 단일 호출에서 반환되는 것은 아닙니다. 단일 호출에서 반환될 수 있는 최대 키 수는 256개입니다.

반환 값

형식: SCESTATUS

함수 호출의 결과를 나타내는 SCESTATUS 값입니다. 함수가 성공하면 SCESTATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나일 수 있는 오류 값을 반환합니다.

반환 코드 설명
SCESTATUS_INVALID_PARAMETER
 함수에 전달된 매개 변수 중 하나가 잘못되었습니다.
SCESTATUS_RECORD_NOT_FOUND
 보안 데이터베이스에서 지정된 레코드를 찾을 수 없습니다.
SCESTATUS_BAD_FORMAT
 형식이 잘못되었습니다.
SCESTATUS_OTHER_ERROR
 알 수 없는 오류가 발생했습니다.
SCESTATUS_NOT_ENOUGH_RESOURCE
 메모리가 부족합니다.

설명

보안 구성 도구 집합은 PFSCE_QUERY_INFO 호출되면 버퍼를 할당합니다. 이러한 버퍼를 해제하려면 반환된 정보가 더 이상 필요하지 않은 후 PFSCE_FREE_INFO 호출합니다.

예제

예제 정보 참조
구성 정보 검색 SceSvcAttachmentConfig 구현
분석 정보 검색 SceSvcAttachmentAnalyze 구현
구성 및 분석 정보 검색 SceSvcAttachmentUpdate 구현
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 scesvc.h

추가 정보

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO