共用方式為


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;否則,它會傳回錯誤值,可以是下列其中一項。

傳回碼 Description
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