PifMgr_GetProperties-Funktion (shlobj_core.h)
[PifMgr_GetProperties steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Gibt einen angegebenen Datenblock aus einer PIF-Datei zurück.
Syntax
int PifMgr_GetProperties(
[in, optional] HANDLE hProps,
[in, optional] PCSTR pszGroup,
[out, optional] void *lpProps,
int cbProps,
UINT flOpt
);
Parameter
[in, optional] hProps
Typ: HANDLE
Ein Handle für die Eigenschaften einer Anwendung. Dieser Parameter sollte auf den Wert festgelegt werden, der von PifMgr_OpenProperties zurückgegeben wird.
[in, optional] pszGroup
Typ: PCSTR
Eine NULL-endende 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"
[out, optional] lpProps
Typ: void*
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf eine PROPPRG-Struktur .
cbProps
Typ: int
Die Größe des Puffers in Bytes, auf den lpProps verweist.
flOpt
Typ: UINT
Legen Sie diesen Parameter auf GETPROPS_NONE fest.
Rückgabewert
Typ: int
Gibt NULL zurück, wenn dies erfolgreich ist. Wenn der Fehler nicht erfolgreich ist, gibt die Funktion das Handle an die Anwendungseigenschaften zurück, die als hProps übergeben wurden.
Hinweise
Wenn es sich bei dem Block um einen "benannten" Block handelt, muss es sich um den Namen einer verknüpften Erweiterung innerhalb der PIF-Datei handeln. Dies kann ein beliebiger vordefinierter Name (z. B. "WINDOWS 386 3.0") oder der Name Ihres eigenen Blocks sein. Sie können ihre eigenen benannten Datenblöcke mit PifMgr_SetProperties erstellen. Benannte Daten können auch als Rohdaten betrachtet werden, da sie ohne Übersetzung an die aufrufende Anwendung zurückgegeben werden.
Die Größe eines benannten Blocks kann durch Aufrufen von PifMgr_GetProperties mit cbProps auf 0 festgelegt werden. Es werden keine Daten kopiert, aber die Größe des angeforderten Blocks wird zurückgegeben.
Alle benannten Blöcke können aufgelistet werden, indem pszGroup auf NULL festgelegt wird. lpProps muss ein Zeiger auf einen 16-Byte-Puffer sein, der den angeforderten Blocknamen enthalten soll, und cbProps muss auf den nullbasierten Blockindex festgelegt werden. Der Rückgabewert ist die Größe des Blocks oder null, wenn der Block nicht gefunden wird.
Wenn Sie einen unbenannten Eigenschaftenblock anfordern, indem Sie den Selektor des namensparameters auf NULL festlegen und der Offset eine Ordnungszahl der Eigenschaftengruppe ist, wird die zugeordnete Struktur zurückgegeben. Beispielsweise gibt PifMgr_GetProperties(GROUP_TSK) eine vordefinierte Struktur zurück, die alle aufgabenbezogenen Informationen in einem Format enthält, das von der PIF-Datei unabhängig ist. Dies ist ein wertvoller Dienst, da er das Aufrufen von Anwendungen von der Bearbeitung von PIF-Dateien befreit, die eine Vielzahl von Abschnitten (als PIF-Erweiterungen bezeichnet) enthalten, wenn nur einer benötigt wird.
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) |