PifMgr_OpenProperties-Funktion (shlobj_core.h)
[PifMgr_OpenProperties 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.]
Öffnet die PIF-Datei, die einer Microsoft MS-DOS-Anwendung zugeordnet ist, und gibt ein Handle für die Eigenschaften der Anwendung zurück.
Syntax
HANDLE PifMgr_OpenProperties(
[in] PCWSTR pszApp,
[in, optional] PCWSTR pszPIF,
UINT hInf,
UINT flOpt
);
Parameter
[in] pszApp
Typ: PCWSTR
Eine mit NULL endende Unicode-Zeichenfolge, die den Namen der Anwendung enthält.
[in, optional] pszPIF
Typ: PCWSTR
Eine mit NULL endende Unicode-Zeichenfolge, die den Namen der PIF-Datei enthält.
hInf
Typ: UINT
Ein Handle für die INF-Datei der Anwendung. Legen Sie diesen Wert auf null fest, wenn keine INF-Datei vorhanden ist. Legen Sie diesen Wert auf -1 fest, um zu verhindern, dass die INF-Datei verarbeitet wird.
flOpt
Typ: UINT
Ein Flag, das die Funktionsweise der Funktion steuert.
OPENPROPS_INHIBITPIF
Ignorieren Sie alle vorhandenen PIF-Dateien, und rufen Sie die Eigenschaften aus win.ini oder _Default.pif ab. Dieses Flag wird unter Windows NT, Windows 2000 und Windows XP ignoriert.
OPENPROPS_NONE
Es wurden keine Optionen angegeben.
Rückgabewert
Typ: HANDLE
Gibt ein Handle für die Eigenschaften der Anwendung zurück. Verwenden Sie dieses Handle, wenn Sie die zugehörigen PIF-Funktionen aufrufen.
Hinweise
Sie sollten sich PifMgr_OpenProperties nicht als eine Funktion vorstellen, die eine Datei irgendwo öffnet. Die PIF-Datei bleibt nach diesem Aufruf nicht geöffnet. Es ist nützlicher, sich die Funktion als Eigenschaftsstrukturzuordnung zu vorstellen, die Sie mithilfe von Datenträgerdaten initialisieren können. Der Hauptgrund, warum diese Funktion fehlschlägt, ist, dass die angegebene PIF-Datei nicht geöffnet werden kann.
Wenn keine PIF-Datei vorhanden ist, ordnet die Funktion weiterhin einen Datenblock im Arbeitsspeicher zu und initialisiert ihn mit Daten aus _Default.pif oder seinen internen Standardwerten. Wenn die Funktion nach einem PIF-Dateinamen sucht, ihn aber nicht findet, erstellt sie einen Namen und speichert ihn in der internen PIF-Datenstruktur. Dadurch wird sichergestellt, dass die Daten auf dem Datenträger gespeichert werden, wenn PifMgr_SetProperties aufgerufen wird.
Wenn die Funktion die PIF-Datei nicht findet, sucht sie in der folgenden Reihenfolge danach.
- Durchsucht das aktuelle Verzeichnis.
- Durchsucht das angegebene Verzeichnis.
- Sucht im PIF-Verzeichnis.
- Durchsucht die von der PATH-Umgebungsvariablen angegebenen Ordner.
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) |