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

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

값	의미
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