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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 5.0 oder höher) |