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

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