Funzione AttachPropertyInstanceEx

La funzione AttachPropertyInstanceEx esegue il mapping di una proprietà esistente a una posizione specifica nei dati riconosciuti e modifica il valore dei dati della proprietà.

Sintassi

BOOL WINAPI AttachPropertyInstanceEx(
  _In_ HFRAME    hFrame,
  _In_ HPROPERTY hProperty,
  _In_ DWORD     Length,
  _In_ ULPVOID   lpData,
  _In_ DWORD     LengthEx,
  _In_ ULPVOID   lpDataEx,
  _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 .

LengthEx [in]

Lunghezza in byte della lunghezza estesa dei dati.

lpDataEx [in]

Puntatore ai dati estesi, che in genere è una variabile dello stack che contiene i dati di estensione.

HelpID [in]

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

Il numero helpID è 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 9. Il livello 15 è un valore speciale che consente al 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 AttachPropertyInstanceEx viene chiamata durante l'implementazione della funzione di esportazione AttachProperties . Quando una proprietà viene associata ai dati tramite AttachPropertyInstanceEx, Monitoraggio di rete crea una struttura PROPERTYINST che definisce l'istanza della proprietà associata e una struttura PROPERTYINSTEX che definisce i dati estesi.

Se si chiama AttachPropertyInstanceEx e non vengono forniti dati estesi, il parametro lpDataEx è NULL o il parametro LengthEx è 0, la chiamata AttachPropertyInstanceEx equivale funzionalmente a una chiamata AttachPropertyInstance.

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.

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