funzione PifMgr_GetProperties (shlobj_core.h)

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

Restituisce un blocco di dati specificato da un file con estensione pif.

Sintassi

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

Parametri

[in, optional] hProps

Tipo: HANDLE

Handle per le proprietà di un'applicazione. Questo parametro deve essere impostato sul valore restituito da PifMgr_OpenProperties.

[in, optional] pszGroup

Tipo: PCSTR

Stringa con terminazione Null contenente il nome del gruppo di proprietà. Può essere uno dei seguenti o qualsiasi altro nome che corrisponde a un'estensione .pif valida.

"WINDOWS 286 3.0"

"WINDOWS 386 3.0"

"WINDOWS VMM 4.0"

"WINDOWS NT 3.1"

"WINDOWS NT 4.0"

[out, optional] lpProps

Tipo: void*

Quando termina, questa funzione contiene un puntatore a una struttura PROPPRG .

cbProps

Tipo: int

Dimensioni del buffer, in byte, a cui punta lpProps.

flOpt

Tipo: UINT

Impostare questo parametro su GETPROPS_NONE.

Valore restituito

Tipo: int

Restituisce NULL in caso di esito positivo. In caso di esito negativo, la funzione restituisce l'handle alle proprietà dell'applicazione passate come hProps.

Commenti

Se il blocco è un blocco "denominato", deve essere il nome di un'estensione collegata all'interno del file pif. Può trattarsi di qualsiasi nome predefinito (ad esempio, "WINDOWS 386 3.0") o il nome del blocco personalizzato. È possibile creare blocchi di dati denominati usando PifMgr_SetProperties. I dati denominati possono anche essere considerati come dati non elaborati, perché vengono restituiti all'applicazione chiamante così come sono, senza traslazione.

Le dimensioni di un blocco denominato possono essere determinate chiamando PifMgr_GetProperties con cbProps impostato su 0. Non vengono copiati dati, ma vengono restituite le dimensioni del blocco richiesto.

Tutti i blocchi denominati possono essere enumerati impostando pszGroup su NULL. lpProps deve essere un puntatore a un buffer a 16 byte per contenere il nome del blocco richiesto e cbProps deve essere impostato sull'indice del blocco in base zero. Il valore restituito è la dimensione del blocco oppure zero se il blocco non viene trovato.

Se si richiede un blocco di proprietà senza nome impostando il selettore del parametro name su NULL e l'offset è un ordinale del gruppo di proprietà, viene restituita la struttura associata. Ad esempio, PifMgr_GetProperties(GROUP_TSK) restituisce una struttura predefinita che contiene tutte le informazioni correlate all'attività in un formato indipendente dal file pif. Si tratta di un servizio prezioso perché consente di chiamare le applicazioni dalla gestione di file con estensione pif che contengono un'ampia gamma di sezioni (note come estensioni pif), quando ne è necessaria una sola.

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_OpenProperties