Funzione FormatPropertyInstance
La funzione FormatPropertyInstance formatta i dati dell'istanza della proprietà usando il formattatore generico fornito da Monitoraggio di rete.
Sintassi
DWORD WINAPIV FormatPropertyInstance(
_Inout_ LPPROPERTYINST lpPropertyInst
);
Parametri
-
lpPropertyInst [in, out]
-
Puntatore a una struttura PROPERTYINST contenente i dati dell'istanza.
In input, il formattatore generico accetta i dati dell'istanza da uno dei membri dell'unione PROPERTYINST e converte i dati in una stringa formattata predefinita.
Nell'output, il formattatore generico imposta il membro szPropertyText della struttura PROPERTYINST su un puntatore alla stringa formattata.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NMERR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore da NMerr.h.
Commenti
La DLL parser chiama indirettamente la funzione FormatPropertyInstance quando il formattatore generico è necessario per formattare i dati per la visualizzazione nel riquadro dei dettagli dell'interfaccia utente di Monitoraggio di rete. Per chiamare FormatPropertyInstance , specificarlo nel membro InstanceData della struttura PROPERTYINFO quando si definisce la proprietà.
Nota
Il parser non riconosce quale funzione viene chiamata quando deve formattare un'istanza di una proprietà. La funzione può essere FormatPropertyInstance o una funzione di formato personalizzata definita dal parser. Il parser chiama qualsiasi funzione di formato specificata dal membro InstanceData della struttura PROPERTYINFO per la proprietà.
Per altre informazioni e un esempio di come implementare le proprietà di formato, vedere Implementazione di FormatProperties. Per altre informazioni su come il formattatore generico formatta diversi tipi di dati, vedere Output formatore generico.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
Server minimo supportato |
Windows 2000 Server [solo app desktop] |
Intestazione |
|
Libreria |
|
DLL |
|