PFSCE_SET_INFO Rückruffunktion (scesvc.h)

Artikel
03/04/2024

Die PFSCE_SET_INFO Rückruffunktion legt dienstspezifische Konfigurations- und Analyseinformationen fest oder überschreibt diese.

Syntax

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

Parameter

[in] sceHandle

Typ: SCE_HANDLE

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

[in] sceType

Typ: SCESVC_INFO_TYPE

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

Wert	Bedeutung
SCE_SERVICE_CONFIGURATION_INFO	Gibt an, dass Konfigurationsinformationen festgelegt sind.
SCE_SERVICE_ANALYSIS_INFO	Gibt an, dass Analyseinformationen festgelegt sind.

[in, optional] lpPrefix

Typ: LPTSTR

Gibt an, welche Informationen festgelegt oder überschrieben werden sollen. Diese Zeichenfolge kann einen bestimmten Schlüssel (siehe bExact) oder ein Präfix für einen Satz von Schlüsseln angeben. Wenn eine Zeichenfolge angegeben wird, werden nur Informationen für diese Schlüssel (und ihre entsprechenden Werte) festgelegt, die der Zeichenfolge entsprechen. Bei Festlegung auf NULL werden alle Informationen für den Dienst festgelegt.

[in] bExact

Typ: BOOL

Gibt an, ob die von lpPrefix bereitgestellte Zeichenfolge als ein bestimmter Schlüssel oder als Präfix für einen Satz von Schlüsseln 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. Nur dieser Schlüssel ist festgelegt.
FALSE	Die von lpPrefix angegebene Zeichenfolge stellt ein Präfix für einen Satz von Schlüsseln dar. Alle Schlüssel (und deren Werte), die dasselbe Präfix haben, werden festgelegt.

[in] pvInfo

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.

Rückgabewert

Typ: SCESTATUS

Wenn die Funktion erfolgreich ist, wird SCESTATUS_SUCCESS zurückgegeben. Andernfalls wird ein Fehlerwert zurückgegeben, der einer der folgenden Sein kann.

Rückgabecode	Beschreibung
SCESTATUS_ACCESS_DENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um diese Aktion abzuschließen.
SCESTATUS_BAD_FORMAT	Das Format ist ungültig.
SCESTATUS_PREFIX_OVERFLOW	Es gibt mehr Daten, als der Puffer enthalten kann.
SCESTATUS_INVALID_PARAMETER	Einer der an die Funktion übergebenen Parameter war ungültig.
SCESTATUS_NOT_ENOUGH_RESOURCE	Es ist nicht genügend Arbeitsspeicher vorhanden.
SCESTATUS_OTHER_ERROR	Ein unbekannter Fehler ist aufgetreten.
SCESTATUS_RECORD_NOT_FOUND	Der angegebene Datensatz wurde in der Sicherheitsdatenbank nicht gefunden.

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_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Freigeben über