PFSCE_QUERY_INFO Rückruffunktion (scesvc.h)

Artikel
03/06/2024

Die PFSCE_QUERY_INFO Rückruffunktion fragt dienstspezifische Informationen aus der Sicherheitskonfigurationsdatei oder Analysedatenbank ab.

Syntax

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
)
{...}

Parameter

[in] sceHandle

Typ: SCE_HANDLE

Gibt das undurchsichtige Handle an, das vom Sicherheitskonfigurationstool während des Aufrufs von ISceSvcAttachmentData::Initialize an die Anlage übergeben wird. Dieses Handle wird verwendet, um die abgefragten Informationen zu speichern.

[in] sceType

Typ: SCESVC_INFO_TYPE

Gibt den Typ der abzufragten Informationen an. Geben Sie eines der folgenden Flags an.

Wert	Bedeutung
SCE_SERVICE_CONFIGURATION_INFO	Fordert Konfigurationsinformationen aus der Datenbank an.
SCE_SERVICE_ANALYSIS_INFO	Fordert Analyseinformationen aus der Datenbank an.

[in, optional] lpPrefix

Typ: LPTSTR

Gibt ein Präfix oder einen Schlüssel (siehe bExact) zum Einschränken der Abfrage an. Wenn eine Zeichenfolge angegeben wird, werden nur die Schlüssel (und die entsprechenden Werte) zurückgegeben, die der Zeichenfolge entsprechen. Bei Festlegung auf NULL werden alle Schlüssel zurückgegeben.

[in] bExact

Typ: BOOL

Gibt an, ob die von lpPrefix bereitgestellte Zeichenfolge als ein bestimmter Schlüssel oder als Präfix behandelt werden soll. Dieser Parameter wird ignoriert, wenn lpPrefix auf NULL festgelegt ist. Geben Sie einen der folgenden Werte an.

Wert	Bedeutung
TRUE	Die in lpPrefix angegebene Zeichenfolge stellt einen bestimmten Schlüssel dar. Es werden nur Datensätze zurückgegeben, die mit diesem Schlüssel übereinstimmen.
FALSE	Die von lpPrefix angegebene Zeichenfolge stellt ein Präfix dar. Alle Schlüssel (und deren Werte), die das gleiche Präfix aufweisen, werden zurückgegeben.

[out] ppvInfo

Typ: PVOID*

Gibt einen Zeiger auf eine der folgenden Strukturen zurück. Der Sicherheitskonfigurationstoolsatz (nicht die Anlage) ordnet den Puffer für die Informationen zu. Daher muss dieser Zeiger auf NULL zeigen.

Wert	Bedeutung
SCESVC_CONFIGURATION_INFO	Wenn sceType auf SCE_SERVICE_CONFIGURATION_INFO festgelegt ist.
SCESVC_ANALYSIS_INFO	Wenn sceType auf SCE_SERVICE_ANALYSIS_INFO festgelegt ist.

[out] psceEnumHandle

Typ: PSCE_ENUMERATION_CONTEXT

Gibt ein Handle zurück, das in aufeinander folgenden Aufrufen dieser Funktion verwendet werden kann. Aufgrund der großen Anzahl von Schlüsseln, die möglicherweise vorhanden sind, werden nicht alle Schlüssel in einem einzigen Anruf zurückgegeben. Die maximale Anzahl von Schlüsseln, die in einem einzelnen Anruf zurückgegeben werden können, beträgt 256.

Rückgabewert

Typ: SCESTATUS

Ein SCESTATUS-Wert , der das Ergebnis des Funktionsaufrufs angibt. Wenn die Funktion erfolgreich ist, wird SCESTATUS_SUCCESS zurückgegeben. Andernfalls wird ein Fehlerwert zurückgegeben, der wie folgt aussehen kann.

Rückgabecode	Beschreibung
SCESTATUS_INVALID_PARAMETER	Einer der an die Funktion übergebenen Parameter war ungültig.
SCESTATUS_RECORD_NOT_FOUND	Der angegebene Datensatz wurde in der Sicherheitsdatenbank nicht gefunden.
SCESTATUS_BAD_FORMAT	Das Format ist ungültig.
SCESTATUS_OTHER_ERROR	Ein unbekannter Fehler ist aufgetreten.
SCESTATUS_NOT_ENOUGH_RESOURCE	Es ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

Der Sicherheitskonfigurationstoolsatz ordnet Puffer zu, wenn PFSCE_QUERY_INFO aufgerufen wird. Um diese Puffer freizugeben, rufen Sie PFSCE_FREE_INFO auf, nachdem die zurückgegebenen Informationen nicht mehr benötigt werden.

Beispiele

Beispiel für	Siehe
Abrufen von Konfigurationsinformationen	Implementieren von SceSvcAttachmentConfig
Abrufen von Analyseinformationen	Implementieren von SceSvcAttachmentAnalyze
Abrufen von Konfigurations- und Analyseinformationen	Implementieren von SceSvcAttachmentUpdate

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	scesvc.h

Weitere Informationen

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Freigeben über