Funzione AttachPropertyInstance

La funzione AttachPropertyInstance esegue il mapping di una proprietà esistente a una posizione specifica nei dati riconosciuti.

Sintassi

BOOL WINAPI AttachPropertyInstance(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     HelpID,
  _In_ DWORD     IndentLevel,
  _In_ DWORD     IFlags
);

Parametri

hFrame [in]

Handle per il frame analizzato. Usare l'handle passato alla DLL del parser nel parametro hFrame della funzione AttachProperties .

hProperty [in]

Handle in una struttura PROPERTYINFO che definisce la proprietà . Quando si implementa la funzione register export si specifica la struttura PROPERTYINFO che definisce la proprietà .

Lunghezza [in]

Lunghezza dei dati per questa istanza della proprietà .

lpData [in]

Puntatore alla posizione nei dati riconosciuti in cui si trova il valore della proprietà. Usare il puntatore passato alla DLL del parser nel parametro lpProtocol della funzione AttachProperties .

HelpID [in]

Identificatore (da 0 a 2047) usato per impostare la Guida sensibile al contesto per la proprietà .

Il numero di identificatore è relativo al file della Guida associato al database delle proprietà del protocollo.

IndentLevel [in]

Livello di rientro (da 0 a 15) usato per visualizzare una proprietà in modo gerarchico.

Monitoraggio di rete usa i livelli da 0 a 14 per impostare il rientro delle proprietà. Il livello 15 è un valore speciale che consente a un parser di associare una proprietà nascosta non visibile.

IFlags [in]

Valore del campo BIT che indica l'ordine dei BIT all'interno di una proprietà. I parser precedenti che impostano fError su 0 o 1, ora impostano fError su IFLAG_ERROR. Impostare questo parametro su uno dei valori seguenti.

Valore	Significato
IFLAG_ERROR	I dati nel frame presentano un errore.
IFLAG_SWAPPED	Al momento del collegamento, word byte è un formato non Intel.
IFLAG_UNICODE	Al momento del collegamento, STRING è Unicode.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE.

Commenti

La funzione AttachPropertyInstance viene chiamata durante l'implementazione della funzione di esportazione AttachProperties . Quando una proprietà è associata ai dati, Monitoraggio di rete crea una struttura PROPERTYINST che definisce l'istanza della proprietà associata.

Durante l'implementazione di AttachProperties, chiamare AttachPropertyInstance per usare i dati esistenti nell'acquisizione. È anche possibile chiamare la funzione AttachPropertyInstanceEx per modificare i dati della proprietà. Tuttavia, è consigliabile usare i dati così come sono presenti nell'acquisizione.

Per informazioni su	Vedere
Quali parser sono e come funzionano con Monitoraggio di rete.	Parser
Come chiamare AttachPropertyInstance.	Implementazione di AttachProperties

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

AttachProperties

AttachPropertyInstanceEx

PROPERTYINST