다음을 통해 공유


PFSCE_SET_INFO 콜백 함수(scesvc.h)

PFSCE_SET_INFO 콜백 함수는 서비스별 구성 및 분석 정보를 설정하거나 덮어씁니다.

구문

PFSCE_SET_INFO PfsceSetInfo;

SCESTATUS PfsceSetInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [in]           PVOID pvInfo
)
{...}

매개 변수

[in] sceHandle

형식: SCE_HANDLE

ISceSvcAttachmentData::Initialize를 호출하는 동안 보안 구성 도구 집합에 의해 첨부 파일에 전달된 불투명 SCE 핸들을 지정합니다. 이 핸들은 정보를 설정하거나 덮어쓰는 데 사용됩니다.

[in] sceType

형식: SCESVC_INFO_TYPE

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

의미
SCE_SERVICE_CONFIGURATION_INFO
구성 정보가 설정되었음을 나타냅니다.
SCE_SERVICE_ANALYSIS_INFO
분석 정보가 설정되었음을 나타냅니다.

[in, optional] lpPrefix

형식: LPTSTR

설정하거나 덮어쓸 정보를 지정합니다. 이 문자열은 특정 키( bExact 참조) 또는 키 집합의 접두사를 지정할 수 있습니다. 문자열이 제공되면 문자열과 일치하는 키(및 해당 값)에 대한 정보만 설정됩니다. NULL로 설정하면 서비스에 대한 모든 정보가 설정됩니다.

[in] bExact

형식: BOOL

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

다음 값 중 하나를 지정합니다.

의미
TRUE
lpPrefix에 지정된 문자열은 특정 키를 나타냅니다. 해당 키만 설정됩니다.
FALSE
lpPrefix로 지정된 문자열은 키 집합의 접두사를 나타냅니다. 접두사는 동일한 모든 키(및 해당 값)가 설정됩니다.

[in] pvInfo

형식: PVOID

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

의미
SCESVC_CONFIGURATION_INFO
sceType이 SCE_SERVICE_CONFIGURATION_INFO 로 설정된 경우
SCESVC_ANALYSIS_INFO
sceType이 SCE_SERVICE_ANALYSIS_INFO 로 설정된 경우

반환 값

형식: SCESTATUS

함수가 성공하면 SCESTATUS_SUCCESS 반환합니다. 그렇지 않으면 다음 중 하나일 수 있는 오류 값을 반환합니다.

반환 코드 설명
SCESTATUS_ACCESS_DENIED
호출자에게 이 작업을 완료할 수 있는 충분한 권한이 없습니다.
SCESTATUS_BAD_FORMAT
형식이 잘못되었습니다.
SCESTATUS_PREFIX_OVERFLOW
버퍼가 보유할 수 있는 것보다 많은 데이터가 있습니다.
SCESTATUS_INVALID_PARAMETER
함수에 전달된 매개 변수 중 하나가 잘못되었습니다.
SCESTATUS_NOT_ENOUGH_RESOURCE
메모리가 부족합니다.
SCESTATUS_OTHER_ERROR
알 수 없는 오류가 발생했습니다.
SCESTATUS_RECORD_NOT_FOUND
보안 데이터베이스에서 지정된 레코드를 찾을 수 없습니다.

요구 사항

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

추가 정보

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO