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	Netmon.h
Libreria	Nmapi.lib
DLL	Nmapi.dll

Vedi anche

PROPERTYINFO

PROPERTYINST