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