Metodo IFilter::Init (filter.h)

Articolo
08/23/2023

Nota

Il servizio di indicizzazione non è più supportato a partire da Windows XP e non è disponibile per l'uso a partire da Windows 8. Usare invece Windows Search per la ricerca sul lato client e Microsoft Search Server Express per la ricerca sul lato server.

Inizializza una sessione di filtro.

Sintassi

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

Parametri

[in] grfFlags

Valori dell'enumerazione IFILTER_INIT per controllare la standardizzazione del testo, l'output delle proprietà, l'ambito di incorporamento e i modelli di accesso IFilter .

[in] cAttributes

Dimensione della matrice di attributi. Quando non zero, cAttributes ha la precedenza sugli attributi specificati in grfFlags. Se non vengono specificati flag di attributo e cAttributes è zero, il valore predefinito viene assegnato dal set di proprietà di archiviazione PSGUID_STORAGE, che contiene la data e l'ora dell'ultima scrittura nel file, le dimensioni e così via; e dalla PID_STG_CONTENTS proprietà "contenuto", che esegue il mapping al contenuto principale del file. Per altre informazioni sulle proprietà e sui set di proprietà, vedere Set di proprietà.

[in] aAttributes

Puntatore a una matrice di strutture FULLPROPSPEC per le proprietà richieste. Quando cAttributes è diverso da zero, vengono restituite solo le proprietà in aAttributes .

[out] pFlags

Informazioni sulle proprietà aggiuntive disponibili per il chiamante; dall'enumerazione IFILTER_FLAGS .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	L'operazione è stata completata correttamente.
E_FAIL	Il file da filtrare non è stato caricato in precedenza.
E_INVALIDARG	Conteggio e contenuto degli attributi non accettano.
FILTER_E_PASSWORD	L'accesso è stato negato a causa della protezione delle password o di misure di sicurezza simili.
FILTER_E_ACCESS	Errori generali di accesso

Commenti

Il metodo Init imposta lo stato dell'oggetto filter. Le posizioni del filtro contenuto all'inizio dell'oggetto e lo stato dell'oggetto viene bloccato finché l'oggetto non viene rilasciato. È possibile passare l'oggetto filtro il set di proprietà che si desidera restituire impostando le descrizioni dell'identificatore di proprietà e dell'identificatore di proprietà (ID) nella matrice aAttributes . Per altre informazioni, vedere Filtro delle proprietà dei file.

Note ai chiamanti

Chiamare il metodo Init prima di chiamare tutti gli altri metodi IFilter .

Note per gli implementatori

Gli ID chunk devono rimanere coerenti tra più chiamate al metodo Init con gli stessi parametri.

Per alcune implementazioni dell'interfaccia IFilter , il rilevamento dell'errore di accesso a un documento potrebbe non essere possibile (o potrebbe essere costoso per il calcolo) fino a quando il metodo Init non è stato chiamato o eventualmente anche in un secondo momento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	filter.h