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 Di esportazione register 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 della lunghezza dei dati estesa in byte.

lpDataEx [in]

Puntatore ai dati estesi, che in genere è una variabile 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à gerarchicamente.

Monitoraggio rete usa i livelli da 0 a 9. Il livello 15 è un valore speciale che consente al parser di collegare una proprietà nascosta che non è visibile.

IFlags [in]

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

Valore Significato
IFLAG_ERROR
I dati nel frame hanno 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à è associata ai dati usando 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 AttachPropertyInstanceEx viene chiamato e non vengono forniti dati estesi, il parametro lpDataEx è NULL o il parametro LengthEx è 0, la chiamata AttachPropertyInstanceEx equivale in modo funzionale a una chiamata AttachPropertyInstance.

Durante l'implementazione di AttachProperties, chiamare AttachPropertyInstance per usare i dati in quanto presenti nell'acquisizione. È anche possibile chiamare la funzione AttachPropertyInstanceEx per modificare i dati delle proprietà. Tuttavia, è consigliabile usare i dati in quanto 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