funzione PifMgr_OpenProperties (shlobj_core.h)

Articolo
03/02/2024

[PifMgr_OpenProperties è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Apre il file pif associato a un'applicazione Microsoft MS-DOS e restituisce un handle alle proprietà dell'applicazione.

Sintassi

HANDLE PifMgr_OpenProperties(
  [in]           PCWSTR pszApp,
  [in, optional] PCWSTR pszPIF,
                 UINT   hInf,
                 UINT   flOpt
);

Parametri

[in] pszApp

Tipo: PCWSTR

Stringa Unicode con terminazione Null contenente il nome dell'applicazione.

[in, optional] pszPIF

Tipo: PCWSTR

Stringa Unicode con terminazione Null contenente il nome del file con estensione pif.

hInf

Tipo: UINT

Handle per il file inf dell'applicazione. Impostare questo valore su zero se non è presente alcun file inf. Impostare questo valore su -1 per impedire l'elaborazione del file inf.

flOpt

Tipo: UINT

Flag che controlla il funzionamento della funzione.

OPENPROPS_INHIBITPIF

Ignorare tutti i file con estensione pif esistenti e ottenere le proprietà da win.ini o _Default.pif. Questo flag viene ignorato in Windows NT, Windows 2000 e Windows XP.

OPENPROPS_NONE

Nessuna opzione è stata specificata.

Valore restituito

Tipo: HANDLE

Restituisce un handle alle proprietà dell'applicazione. Usare questo handle quando si chiamano le funzioni .pif correlate.

Commenti

Non è consigliabile considerare PifMgr_OpenProperties come una funzione che apre un file da qualche parte. Il file con estensione pif non rimane aperto dopo questa chiamata. È più utile considerare la funzione come allocatore della struttura di proprietà che è possibile inizializzare usando i dati del disco. Il motivo principale per cui questa funzione ha esito negativo è dovuto alla memoria insufficiente o all'impossibilità di aprire il file con estensione pif specificato.

Se non esiste alcun file con estensione pif, la funzione alloca ancora un blocco di dati in memoria e la inizializza con i dati di _Default.pif o le impostazioni predefinite interne. Se la funzione cerca un nome di file con estensione pif ma non la trova, costruisce un nome e la salva nella struttura dei dati con estensione pif interna. Ciò garantisce che, se viene chiamato PifMgr_SetProperties , i dati vengono salvati su disco.

Se la funzione non trova il file con estensione pif, la ricerca viene eseguita nell'ordine seguente.

Cerca nella directory corrente.
Cerca nella directory specificata.
Cerca nella directory .pif.
Cerca le cartelle specificate dalla variabile di ambiente PATH.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

PifMgr_CloseProperties

PifMgr_GetProperties

Condividi tramite