PifMgr_SetProperties-Funktion (shlobj_core.h)

[PifMgr_SetProperties ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Weist einem Datenblock aus einer PIF-Datei Werte zu.

Syntax

int PifMgr_SetProperties(
  [in, optional] HANDLE     hProps,
  [in, optional] PCSTR      pszGroup,
  [in]           const void *lpProps,
                 int        cbProps,
                 UINT       flOpt
);

Parameter

[in, optional] hProps

Typ: HANDLE

Ein Handle für die Eigenschaften der Anwendung. Dieser Parameter sollte auf den Wert festgelegt werden, der von PifMgr_OpenProperties zurückgegeben wird.

[in, optional] pszGroup

Typ: PCSTR

Eine MIT NULL beendete ANSI-Zeichenfolge, die den Namen der Eigenschaftengruppe enthält. Es kann sich um einen der folgenden Namen oder einen anderen Namen handeln, der einer gültigen PIF-Erweiterung entspricht.

"WINDOWS 286 3.0"

"WINDOWS 386 3.0"

"WINDOWS VMM 4.0"

"WINDOWS NT 3.1"

"WINDOWS NT 4.0"

[in] lpProps

Typ: const void*

Ein Eigenschaftengruppendatensatzpuffer, der die Daten enthält.

cbProps

Typ: int

Die Größe des Puffers in Bytes, auf den lpProps verweist.

flOpt

Typ: UINT

Immer SETPROPS_NONE.

Rückgabewert

Typ: int

Gibt die Menge der übertragenen Informationen in Bytes zurück. Gibt null zurück, wenn die Gruppe nicht gefunden werden kann oder ein Fehler auftritt.

Anforderungen

Weitere Informationen

PifMgr_GetProperties